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INTRODUCTION 


Tha  PRIM  tyttom  supports  UlOSO  progrsm  dsvoiopmsnt  and  tasting  by  providing  an 
ainuiatad  UlOSO  tool  ambaddad  in  sn  intarsctiva  tima*sharing  anvironmant.  This  amulatad 
UlOSO  providas  powarful  dsbugging  aids  not  found  on  sn  actual  UlOSO  computar  aystam. 


TMs  guide  consists  of  two  sections,  serving  distinct  purposes.  TNs  first  section  is 
an  axtandad  introduction  to  the  PRIM  UlOM  tool  and  its  capabilitiast  it  is  addressed  to  the 
UlOSO  user  with  no  prior  exposure  to  PRIM.  It  consists  of  an  overview  of  the  tool, 
follotaad  by  a detailed  discussion  of  a number  of  common  or  representativo  programming 
problems  with  solutions  illustrated  by  means  of  transcripts  of  actual  sessions  with  the 
PRIM  UlOSO  emulation  tool.  The  second  section  is  an  appendix  to  a separate  document, 
TAe  PRIM  System:  l/ser  Re/erenee  Mamtah  that  manual  and  the  appendix  together 
constitute  the  complete  reference  document  for  the  PRIM  UlOSO  tool.  (The  PRIM  system 
supports  a family  of  emulation  toolsi  the  f/ssr  Re/erenee  Jfemtaf  covers  the  capabilities  of 
the  PRIM  system  as  they  apply  to  all  the  tools  in  general.) 

PRIM  Is  available  through  both  the  NSW  (National  Software  Works)  and  the  USC-iSIC 
TENEX  system,  which  is  a server  system  on  the  ARPANET.  The  user  of  PRIM  is  assumed  to 
have  access  to  one  or  the  other  system  and  some  rudimentary  familiarity  with  its  use. 
Otko  prim  hes  been  entered,  its  behavior  is  identical  in  the  two  environments. 


Tbe  PRIM  UlOSO  tool  consists  of  the  emulated  UlOSO  plus  two  separate  command 
interpreters,  known  as  the  exec  and  the  debugger.  At  any  time,  PRIM  is  either  runrting 
the  UlOSO  emulator  or  processing  user  commands  to  the  exec  or  debuggeri  the  transition 
between  these  states  is  at  the  control  of  the  user. 

Exec  commands  are  concerned  primarily  with  tha  manipulation  of  UlOSO 
environments  and  configurations.  The  elements  of  exec  commands  are  keywords,  file 
names,  and  (decimal)  numbers.  Keywords  include  such  items  as  command  names,  device 
names,  options,  and  parameters.  They  need  not  be  entered  in  their  entirety:  any 
unambiguous  leading  substring  of  the  desired  word  suffices  for  recognition.  (When  a 
keyword  is  terminsted  with  an  aacaps  character,  the  word  is  completed  by  the  exec.)  File 
names  refer  to  files  in  the  user’s  file  space  (in  either  NSW  or  TENEX)^  and  follow  the 
appropriate  file  name  syntax.  Each  file  specification  raquires  the  name,  as  appropriate,  of 
either  an  existing  file  (to  be  read  or  modified)  or  a naw  file  (to  be  created  end  written). 

Debugger  commands  are  corwerned  with  the  detailed  control  of  the  emulated  UlOSO. 
Tha  debugger  includes  the  functions  available  on  the  front  panel  of  the  UlOSO  as  a small 
subset  of  its  capabilities.  Each  debugger  command  word  consists  of  ■ single  characteri  the 
arguments  to  debugger  commands  are  symbolie  expressions  involving  the  elements  of  the 
UlOSO  (e^.,  memory  locations,  index  registers,  OC,  or  tetradsX  user-definod  names  (e^., 
program  labels  or  debugger  formats)^  or  constants. 

WitMn  PRIN^  certain  ASCN  charactars  have  been  assigned  special  functions  when 
input  by  the  user.  These  functions,  which  ars  described  completely  In  the  User  Re/erenee 
MmmmmI,  concern  command  editing  and  PRIM  (command  and  UlOSO)  control.  The  command 
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aditing  function*  ara  baclupaca  (aithar  th*  ASCN  baektpae*  or  entl-A  charactar*)^  backup 
(emtl-WK  dalata  (dal  or  rabaai),  ratyp*  (eatl-K),  and  quoation  (oa*M<*a-aiarb)i  th* 
control  (unctiorta  ara  atatu*  (eail-S)  and  abort  (eatl-X).  Backapaca  back*  up  ovar  orta 
charactar  witNn  tha  currant  fiaid  of  a commar(dt  it  it  acknowladgad  by  a backalath  (\) 
followad  by  th*  araaad  charactar.  Backup  back*  up  ovar  th*  currant  commarMt  fialdt  it  it 
acknowladgad  by  a backalaah  (V>  followad  by  th*  firat  charactar  of  th*  araaad  fiakL 
Dalata  back*  out  of  th*  currant  aubcommand  antiraly  (or  out  of  th*  currant  cowunand  if  not 
in  a aubconanandk  it  la  acknowladgad  by  "XXX",  followad  by  a naw  prompt  Ratyp* 
r*-di*play*  tha  currant  command  or  aubcommand  lin*.  Quaatioiv  whan  antarad  at  th* 
baginnlng  of  a fiaid,  ganarata*  a tummary  of  tha  input  currantly  *)rpact*d,  followad  by  a 
ratyp*  of  th*  lina. 

Statu*  causa*  PRIM  to  roapond  with  tha  currant  atatu*  of  th*  amulatad  U1050. 
Abort  causa*  any  operation  in  prograas  to  b*  tarminatad  clasniy  and  returns  control  to 
tha  top  leval  of  PRIM  (to  aithar  th*  axac  or  debugger,  depending  on  which  one  iaat  had 
controIX  The  abort  function  is  used  both  to  abort  a commmd  that  is  partialty  antarad  or 
in  procaa*  and  to  stop  th*  running  U1050. 

With  this  background  w*  can  now  illustrat*  how  PRIM  can  b*  used.  Two  axampia* 
will  b*  axplorad  in  detail)  th***  example*  will  show  how  to: 

1.  Kay  in  a small  program,  run  it  to  discover  a bug,  fix  tha  bug,  trace  it  to  obsarv*  its 
operation,  and  sav*  tha  results. 

2.  Load  a program  into  manwry  from  a card  dock.  Interrupt  and  sav*  th*  session,  arxl 
continue  it  later  from  th*  asm*  point. 

Several  further  example*  will  b*  presented  with  considerably  lass  detail  to  illustrat*  a 
number  of  ways  in  which  th*  interactiv*  PRIM  debugger  can  be  used.  Thas*  examples  will 
show  how  to: 

1.  Find  which  instructiona  ara  modifying  a location  and  which  ones  are  setting  it  to  a 
designated  value. 

2.  Oatarndne  how  many  timas  a coda  saquanca  is  executed  and  how  atany  times  a data 
location  is  rafarenc^  prior  to  a known  condition  occurring. 

3.  Trace  a loop  only  once. 

4.  Firwl  which  instructiorta  in  a program  ware  eat  executed. 

5.  Test  if  a data  location  has  changed  ovar  ■ cod*  saquanca. 

6.  Search  a buffer  for  a givan  valua. 

In  gorwral,  these  axampias  will  consist  of  transcripts  taken  from  PRIM  sassiona.  The 
tranacripts  typically  will  b*  ambaddad  within  a paragraph  of  text  that  guidas  tha  reader 
through  the  axampi*  and  axplaina  or  ampiifia*  solactad  faaturas  of  it. 
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ElfTBR  AND  DEBUG  A SMAU  PROGRAM 

To  etert,  let  us  follow  a complete  step-by-step  sequence  of  interactions  in  running 
PRNA  keying  in  a sample  program,  running  and  ^bugging  it,  and  saving  the  patched  result. 
In  this  »nd  alt  the  remaining  examples  of  this  guide,  user  inputs  are  in  b^d  italics  with 
serifs,  whereas  PRIM  responses  are  in  a light  sans-serif  font,  input  control  characters  are 
represented  as  superscripts. 

The  session  will  start  at  the  TENEX  exec  level  (the  prompt  character  is  *0*)^  where 
the  U1050  emulator  will  be  called  in  from  the  PRIM  directory  (the  PRIM  prompt  character  is 

A similar  step  would  be  taken  to  run  the  PRIM  UlC^  tool  under  NSW.  Then  the 
PRIM  debugger  will  be  called  in  (the  prompt  character  is  ”e”)  so  that  a small  program  can 
be  keyed  ia  The  debugger  includes  an  assembler  that  can  recognize  UlOSO 
assembly-language  Instructions  and  generate  the  binary  equivalent. 

e<PRIIf**e>k*iUl«*esss.8aV|  a ^ 

uiasa  < tm/ny 

/nstnietlen  #a7yi>«  OlOOO**^ 
aiSSSi  M m FT  0I64,44\ 
aiaast  as  - PDO  ot36oo*6.7\ 
aiai2i  as  • SC  0IJ606,03J\ 
aiai7i  • PD  OI3i77,4\ 
aiazsi  as  - XF  9Il^\ 
aiaaii  aa  . XF  940fi2000^\ 
aiaasi  at  ■ XF 
aiasst  at  - yc  t*l0,43\ 
aissti  as  > y |-10\ 
aiassc  99  • FT  OI6l,44\ 
aisazi  as  ■ XF  02i„^\ 

91997*  99  - XF  640fi2000^\ 

91979*  99  m XF  yi2000H5\ 

tiitii  as  > yc  t*10,43\ 
aiisai  99  m j t-lo\ 
aiiisi  ss  - JD  S*S\ 
aiizti  as  ■ y 01067^ 

tc»  (to) 

— > Unlaploaontod  lnstr«ietlen  at  SSi  SS  t 

The  program  was  Keyed  in  by  typir^  location  01000  (in  instruction  mode)  and  specifying 
replacement  (ending  the  command  with  an  aaeepa  character  rather  that  a eerriage-reiHm). 
The  first  instruction  of  the  test  program  was  entered  as  the  replacement  value,  terminated 
by  a bedk-sfesA  (”\")  to  force  a display  of  the  next  available  location  so  that  K,  t(X>,  could 
be  replaced.  The  last  new  instruction  was  terminated  by  a cerriage-reutm,  which 
completod  the  replacement  sequence.  (At  that  point,  the  user  might  have  reentered  the 
type-with-replacement  commard  so  as  to  inspect  the  program,  instruction  by  instructior), 
and  correct  any  input  errors.)  The  user  executed  the  program  by  telling  the  debugger  to 
start  at  (go  to)  location  01(XX).  This  command  transferred  control  from  the  PRIM  debugger 
to  the  emulstor,  which  executed  the  program  until  it  encountered  a condition  that  caused  it 
to  stop  oxecutiM  — in  this  case,  an  illegal  instruction  at  location  0. 

To  determine  how  the  program  got  to  location  0,  the  user  will  request  a Mstory 
display  of  the  last  32  jumps  and  find  that  the  last  Jump  occurred  from  location  01036,  an 
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XF  inctructtoa  Sine*  tN*  imtruction  it  not  • profram  jump,  th*  trantfor  of  control  mutt 
hav*  boon  eauaod  by  an  intorrupt,  to  th*  ttat*  of  tho  intorrupt-inNbit  flop*  (fRI.  f JU,  and 
/JM)  will  bo  oxamin^  thowinf  that  a cla*t-3  int*rri4>t  occurrod,  protumably  bocauto  th* 
on*-**cond  ono-thot  trigtorod  by  tho  inatruction  at  location  01024  had  firod.  Bocauto 
tho  channol-3  intorrupt  voctor  at  location  0435  wa*  novor  tot,  tuch  an  intorrupt  would 
voctor  to  location  0.  Thit  will  b*  corroctod  by  ontoring  an  int*rrupt*r*turn  Inatruction  at 
location  0430  and  th*  voctor  to  it  at  location  0435.  Aftor  chocking  th*  chango,  tho 
XLEAR  button*  will  b*  "proatod*  (uting  tho  tot  command)  and  th*  program  wlU  bo 
rooxocutod. 

aJiOQ  hUfry  ^ 

aiasa— aiaaaoi  iiom)  aitst— at  IRI:IR9» 

laii  aa  laai  aa  m*  at  «Jf«aa  iMirwetim  Me  mTww  f4J|Me 
a4aai  amsat  - i 

OAS&^lMe  mm,  it  . m 

atasi  a*  - 
«r«t«  Mi5S» 

Masi  Msataat  jSat  SJCLEAR^ 

aCe  (to)  0i00<K*‘ 

— > Hell  tieeiet  •«  •lUSi  X 1112* 

— > Uiasa  Hal  let  at  *112*,  Uaa*  *<**.* 

*1Va  DMYJCLOCK^ 
oav.aocKi  *M3*MMa*s  # 

Not*  on  tho  aocond  lino  how  th*  intorrupt-inhibit  flop*  wor*  tpocifiod  a*  a rang*  of 
location*,  from  IRI  through  lltJ,  and  on  th*  fifth  tin*  how  location*  0435-0437  woro 
tpocifiod  a*  a rango-ttart  and  an  incromont.  Not*  on  tho  tovonth  lino  alto  how  th* 
fivo-byt*  toquonc*  of  addrotto*  from  0435-0441  wat  apocifiod  at  th*  30-bit-wid*  coll 
M43S.  TN*  timo  whon  tho  program  wa*  run  it  stoppod  whor*  oxpoctod.  Th* 
content*  of  tho  day-tim*  clock  woro  oxaminod  and  found  to  hav*  boon  ttopp^  twic*  tine* 
boing  tot  to  2*ro. 

Tho  program  now  appoart  to  cycia,  but  to  verify  that  tuccottiv*  intorrupt*  aro 
boing  handed  properly,  tho  dabuggor  will  b*  inttruetod  to  break  oxocution  on  every 
Interrupt  and  the  program  will  bo  continued 

aBraak  (aO  INT» 

*Ca  (la)  M 

— > Hall  aiaplay  ai  aillSt  X *112* 

— > U1*S*  halia*  ai  *112*.  Uaa*  *1*4.* 

alW*  DAYJCUXK» 
oav.ctacKi  ntmmm  » 

inotood  of  brooking,  howovor,  the  program  haltod  again  at  tho  JD  Inttruction  with  th*  clock 
having  aitvancod  one*  more,  without  an  interrupt  having  occurrod 

Tho  program  will  bo  cycled  on*  more  time  and  found  ttiH  not  to  gonorate  an 
interrupt.  Tho  Interrupt-inMbit  flop*  will  b*  oxaminod,  thowing  that  claat-3  interrupt*  aro 
inhibited  RaaNsing  that  th*  intarrupt-rotum  inttruction  in  location  0430  thouM  hav* 
roaot  IIU,  tho  uaor  will  modify  it  to  eloar  th*  inNbit  flop.  Than  tho  Syttem  Cloar 
"puahbutton*  win  bo  aot  and  tha  program  rottarted 
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iC»  <t«>  ^ 

— > Halt  aiaalay  at  Uttli  JD  MIN 
»>  UlIU  aaltaa  at  MIN,  Uaa4  tiN.I 

«IW  DAYJCLKK^ 
mv.aoCKi  tNNNNN?  #7\iaa 

IRli  N IMi  N IMi  M #Naaa  faatrwt  Ian  •••  mTW 
MNi  JU  MN  • /C  MJI*' 

«Sai  $JCLEAK» 

#Ca  tia)  flO<NK*’ 

— » Claaa  M inlarr«*t  #I\iaa  DAYJCLOCK*^ 
mv.aOGKi  WNNNRM  #T>|aa 
iMi  at  W/ 

— > stn«la-ataa  at  MNi  X MMS,t3I 
INi  N iCa  (ta>  C' 

— » Claaa  M Intarraat  fCa  (ta) 

— > Nalt  Rlaalay  at  M119i  JO  MIN 
— » UlOW  halta<t  at  MIN,  Una*  OiM.O 
#T\iaa  DAYJCWCK^ 

Oav.aoCKi  WONNWm  «Ca  tta)  ^ 

— > Claaa  *9  Intarrvat  i 

TNa  tim*  (on  lin*  10)  th*  interrupt  occurred  After  examining  the  clocK  and  IRS,  the 
program  waa  aingie-atepped  (by  entering  limt-f—i  aa  a debugger  command)  and  IIM  waa 
reexamined  to  verify  that  it  had  been  cleared  Not*  on  iin*  13  that  by  entering  eel**  aa  a 
I debugger  commartd  th*  laat  location  diapiayed  by  th*  user  waa  re^aplayedi  type-outa 

* produced  by  breahpointa  do  not  change  what  la  considred  to  be  th*  laat  location  diapiayed 

Oontinuing  the  program  ahowed  that  it  waa  interrupting  correctly. 

Th*  program  now  appeara  to  worK  correctly.  To  demonatrato  thia,  th*  user  will 
next  trace  the  execution  of  th*  program  to  follow  th*  interrupts  as  they  occur.  This  will 
be  don*  by  clearing  all  existing  breahpoints  and  then  setting  an  execute-break  on  every 
instruction  witNn  th*  program  and  at  th*  interrupt-return  instructiorv  to  avoid  tracirtg 
through  the  two  idto  loops  (inatructiona  at  locations  01036-01054  and  01074-01112),  th* 
execute  breeks  set  for  them  will  be  deleted  In  order  to  produce  a trace,  a simple 
breek-tim*  "debugger  program"  will  be  entered  for  each  breakpoint  that  is  sett  by 
tormirteting  th*  break  command  with  an  •tump*  rather  than  a tmrrimf-rMum,  a 
break-subcommand  moda  will  be  enterad  (an  extra  prompt  character  indicates  this) 
wherein  debugger  commarxls  can  be  supplied  that  are  to  be  executed  automatically  at  th* 
tim*  th*  break  condition  is  detected  by  the  emulator.  This  break-time  program,  in  effect, 
wiH  state:  "print  th*  contents  of  th*  cell  pointed  to  by  OUKX  as  an  instruction  and 
continue*  (breaks  occur  */kar  th*  CPU  cycle  in  which  th*  corKlition  is  detected,  so  CXi  has 
already  been  advanced^ 

aflaarsat  tfraa)  *** 

tBnak  (atl  f 1000:0 1 IM,  0430***  (altar  Salng)  Xaeuta  *** 

Mlfaea  iMiruellan  mOLDCC^ 

UG*  (ta)  ** 

<ar*sr«i  mmsar  la  m>  sDaSraaS  (Iraa)  01036:01064,  01074A 11 11** 

r * 

' ' Not*  on  th*  second  line  that  the  execute-break  locationa  were  entered  as  a list  (the  rang* 

01000-01110  and  th*  location  0430)  and  that  ontoring  an  "Ompty*  aubcommand  (e*rr<*«e- 
rsnim  by  itsolf)  on  th*  fifth  lin*  t*rminat*d  the  br*ak-subcommand  mod*  and  th*  br*ak 
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comiiMnd.  Ev»ry  n»w  brcak-tim*  program  it  attignad  a uniqua  aaquanco  nuaibor  to  that 
it  can  ba  datignatad  aatiiyi  thit  numbar  wat  raportad  on  tha  aixth  Una  aftar  tha  command 
had  boon  accaptad.  Nota  alto  on  tha  tixth  lino  that  a litt  of  two  rangaa  wat  utad  to 
ramova  braakp^ntt  from  both  idia  loopt  with  tha  tanta  command  And  nota  on  tha  third 
Una  that  tha'oparator  wat  utad  to  gat  tha  valua  containad  in  OLDCC  (tha  vaiua  of  OC 
bafora  it  wat  advancadH  at  "•*  it  tha  normal  TIP  intaroapt  charactar,  utart  aooatting  PRIM 
via  a TIP  thould  radafina  tha  intarcapt  charactar. 

A ditplay  of  axitting  braakpointt  will  ba  raquattad  to  varify  that  thay  had  baan 
tpacifiad  corractly.  Aftar  a tyttam  claar,  tha  program  will  ba  raaxacutad  (It  thould  ba 
notad  that  "puthing*  a contola  "button”  only  tatt  a function  bit  for  tha  amulatort  tha 
implamantation  of  tha  function  doat  not  occur  until  tha  amulator  it  run  naxt^  ThIt  tima, 
howavar,  bacauta  of  tha  braak  program,  aach  inttruction  axacutad  (axcapt  thoaa  within 
tha  idIa  loopt)  will  ba  ditplayad  aftar  itt  axacutioa 

flkrMk  (at)  ^ 

atsa  <x>  atttt-aitss  <x>  aitH-ait7t  <x»  tiiia^iuc  <x>  aSat  SJOIMAKP^ 
tC*  (la>  $1000^ 

aiNti  FT  tita.tM 
— > aiatsi  Fot  ai3ttt,t7 
>->  amzi  K tl3Mt,t33 
->>  am7i  Fo  am77,M 
— > aia24<  XF  a2i,at.aa,a) 

— > aiasii  XF  a4t,t2ttt,at,t3 
atxti  jc  aiMs.asi 
— > aitssi  FT  aiti.tM 
aiatxi  XF  t»,N,N,n 
atM7i  XF  a«t,a2tt«,at,ts 
— > atsai  JC  ait74,t)i 
— > aiiisi  « aiixt 

— > Halt  tlaalay  at  CitlSi  JO  OHM 
— > UlOM  haltat  at  tllXt,  Uaaa  Oiia.t 
aCa  (ta)  » 

aitMi  j aiMF 

— > aiM7i  XF  a4t,a2Ma,M,ta 
— > atati  JC  aitFt.m 
—*  atiiSi  JO  oim 
— > Halt  tlaalay  at  ttllSi  « itlM 
— > UltM  haltat  at  ttlXO,  Uaat  Oilt.O 
aC^  eta) 

— > tllMi  J aiW7 
— > aiM7t  XF  att.KON.M.n 
atati  X 01074,031 

— > OlllSi  X OHM 
— > Halt  tlaalay  at  01113i  X OHM 
— > WIOM  haltat  at  OHM,  Uaat  OiU.O 

a 

Oontinuing  tha  program  twico  from  tha  JD  inttruction  damanotraHod  that  tha  Mamiptt 
oceurrad  aa  axpaetad 

To  eomplata  tha  firtt  axamplak  tha  praaram  wM  ba  tavad  by  raturning  from  tha 
PRUd  dabuggor  to  tha  PRM  aaae,  whara  a amia  of  tha  UlOBO  mamory  ihio  tha  fUa 
a(XXTE8T  wM  ba  raquattad 
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#R«t«trn  (t*  IXCC) 

T On*  •!  th« 

NLL 

CONFIOWMTION 

KHOfiY 

SYMOLS 

>SAVC  (on  (Hot  CiJOCKJTESTf 

>0«»«UIT 

Quit  1 109  UltSI  ICen(lrB)  ^ 

• 

Not*  on  th*  Mcond  lln*  that  th*  qutttioH-mark  *licit*d  th*  •vallabi*  option*  within  th* 
•av*  command.  Whan  th*  aav*  command  (iniahad.  PRIM  wa*  tarminatad,  raturning  control 
again  to  tha  TENEX  axac  (not*  th*  prompt  charactar  *•*  on  th*  laat  IlnaX 

LOAD  A CARD  DECK  FOR  EXECUTION 

Th*  aacond  datallad  axampi*  will  go  through  th*  procat*  of  loading  a program  from 
a binary  card  dacK.  Whan  th*  U1050  amulator  it  callad  In,  a atandard  hardwar* 
configuration  i*  auppliad.  Thit  configuration  conaista  of  a U1050  procaaaor  with  a lina 
printar,  card  raadar,  card  punch,  maaa  atorag*  unit  (diaK),  til*  loadar  (tap*),  oparator’a 
conaola,  and  th*  day-tim*  clock  Inatallad.  Th*  uaar’a  (controlling)  tarminal  la  automatically 
connactad  to  tha  oparator’a  conaola.  In  ordar  to  ua*  any  othar  parlpharal  (iavic*, 
howavar.  It  muat  ba  connactad  to  an  Input  aourc*  and/or  output  daatination  — althar  to 
th*  uaar’a  tarminal  or  to  a TENEX  fil*  (or  pair  of  filaa).  Th*  procaaa  of  connacting  th* 
U1050  davic*  to  th*  TENEX  ayatam  la  callad  "mounting.”  Elthar  a TENEX  fil*  or  th*  uaar’a 
tarminal  I*  "mountad*  on  tha  U1050  davic*.  Th*  day-tim*  clock  ha*  arbitrarily  baan 
aaaignad  to  unit  numbar  16  on  channal  3(  although  it  appaar*  in  th*  parlpharal*  diaplay,  It 
i*  not  a mountabi*  davic*.  In  th*  following  axampla,  a baaic  U1050  configuration  will  gat 
TENEX  flla*  mountadi  than  a card  dack  will  b*  loadad  Into  mamory.  Th*  raaulting  ayatam 
will  ba  atoppad,  aavad,  and  continuad  at  a latar  tim*. 

•(//•*««•.  8«V|  « «»' 


UiaSt  ( 4/12/77) 
»P«MERIPNCRM.8 

Cnan  Unit  Reuniaa  0«vle« 

8 

8 

No 

RRIRTER 

1 

8 

No 

REROER 

2 

8 

Re 

RUHCN 

8 

8 

Yet 

LS-conn-URiT 

8 

IS 

Re 

CLOCK 

8 

8 

Re 

DISK 

7 

8 

Re 

TRPE 

>F*M|LiaT«ITUS  (tar  Xavlaa)  ^ 

Raeara  Ft  la  Naaa  Davlea 

a Uaar  Tly  LS-CMW-UNIT 

> 

Th*  configuration  diaplayad  with  th*  parlpharal*  command  ahowad  that  only  LS-comm-unIt 
taro  (oparator'a  conaola)  wa*  mountad.  Th*  atatua  of  mountad  TENEX  flla*  wa*  diaplayad 
with  th*  Fllaatatu*  command)  It  ahowad  that  th*  uaar’a  tarminal  wa*  mountad  on  th* 
LS-comm-unIt. 
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In  IMc  •xampic  th«  utar  wIthM  to  load  tho  program  dodi  Montlflod  aa  148-71  artd 
run  It.  To  allow  printout  from  that  pro|rai>v  a fila  will  hava  to  ba  mountad  on  tha  lirta 
printar.  To  load  148-71,  a Ilia  containing  tha  binary  dacK  will  hava  to  ba  mountad  on  tho 
card  raadar.  And  to  run  148-71  auccasatully,  a fila  raprawntlng  tha  diak  (aa  aat  up  by  a 
pravloua  program)  will  alao  hava  to  ba  mountad. 

»M«MoUIIT  (a,l,a,0L,0U,T,?)  7 Oiw  •«  tlw  fallMlnci 
aaacao 
iiruT 
NCU 
M.0 
OUTaUT 

TNIt-THWiaM. 

>iiowiT  (a,i,a,OL,ou,T.a)  OU***mn  <«•  «iia>  SCRMtM^Kri 

(m  aavlM)  f Oiw  al  tha  fallaala|i 

aaiNTia 

acaoia 

mwcN 

CaWMMlT 

OIIX 

TUN 

CIOCIC 

•flOUNT  M,l,a,0L,0U,T,f)  WmiT  (ta  fila)  lOWTCN.MtTi  91 

Ian  ia^laa) 

> 

Tha  mount  command,  aa  with  all  PIRIM  axac  commanda,  la  largaly  aalt-fulding.  Whanavar 
tha  PRIM  axac  oxpacta  input  from  tha  uaar,  tha  Input  ot  a oMaatlaii-aiarb  will  allcit  aithar  a 
Hat  of  optiona  or  a daacriptlon  of  what  form  of  input  la  axpactad.  In  ganaral,  a mount 
command  daaignataa  what  kind  of  fila,  tha  fila  namo,  and  tho  ill 050  davica  lnvoh^d.  Noto 
that  tha  fuaailoa-MorAa  antarod  to  tha  mount  command  alicitad  tha  avallabla  optlorta  — 
tha  typaa  of  fila  (whan  antarad  on  Hna  1 prior  to  tha  firat  argumant)  and  tha  davleo  namaa 
(whan  antarad  on  lino  9 prior  to  tha  naxt  argumant).  An  output  fila,  SCRATCHPRT,  waa 
mountad  on  tha  printari  it  la  aaaumad  by  PRIM  to  ba  an  ASCit  fila. 

A binary  input  fila,  148-71.CR0^  will  ba  mountad  on  tha  card  raadari  If  a tranalatod 
cord  dock  la  axpactad,  aithar  an  ASCH  or  a column-binary  fila  may  ba  uaad,  but  If  an 
untranalatad  dack  la  axpactad,  only  a column-binary  fila  may  ba  uaad.  In  thia  caaa,  tho 
dock  for  148-71  alraady  haa  boon  loadad  onto  a TENCX  fila  In  column  binary  (1.0.,  aach 
column  of  tha  card  ia  rapraaantad  by  12  bita  in  tha  fila,  with  tha  top  row  baing  tha 
moat-algnlficant  bit  and  tha  bottom  row  tha  laaat  algnlfkant  blt)i  aach  column  unit  la  a 
12-blt  byta.  A binary  input/output  fila,  DISK,  will  ba  mountad  for  tha  diaki  tha  amulator 
aaaumaa  thia  fila  to  ba  binary  with  a 6-bit  byta. 
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>M«M0UNT  «,l,N,«.,OU,T,t)  l—^mn  (IrM  «lla>  I4i-7IJCRD;  J*M  (m  ««vIm) 

»f  IIMMIV  ar  aSCII 

»A*M|NMy 

>lf«MOUNT  m,l,N,OL,W,T,t)  0I.«MD  (In  « Ml  III*)  filSJC^  1***  (m  ^mIm) 

D«Miaic  er 

>F«M|LnTaTM  (Iw  a«ylM>  ^ 

R*Mra  FI  I*  Nmw  OnvlM 

• KMTCM.NTi  31  FRlNtCt 

• 143-71.0(01  1 KEKOCt 

3 UsM  Tty  LS-CONN-UNIT 

3 LeO.OSKi  1 OIMC 

> 

Bacaua*  th*  card  raadtr**  fil*  can  b*  aithor  ASCH  or  binary,  a subcommand  mod*  was 
•nt*r*d  for  th*  mount  command  whar*  fil*  charactaristics  could  b*  suppliad  Sine*  byta 
six*  for  a binary  card  raaiiar  (or  card  punch)  fil*  is  assumad  to  ba  12  bits,  th*  usar  was 
not  askad  to  spacify  it.  And  sinca  a disk  fil*  is  assummad  to  b*  binary  with  a 6-bit  byta, 
tha  uaar  also  was  not  askad  to  spacify  It.  Th*  fllaststus  command  showad  that  tha 
printar,  raadar,  oparator'k  consol*,  and  disk  had  baan  mo^mtad.  Nota  that  as  no  spacific 
davic*  was  dasignatad,  tha  status  of  filas  was  displayad  for  all  mcuntad  davica*. 

Sine*  th*  usar  wants  to  stop  th*  CPU  aftar  th*  dock  has  baan  loadad,  a braakpoint 
will  ba  sat  at  tha  first  instruction  of  th*  program  in  ordar  to  stop  th*  amulator  so  that  th* 
sassion  can  b*  savad  for  futur*  axacution  startir^  at  a point  aftar  tha  load  has  occurrad. 
In  ordar  to  load  tha  card  dock,  tha  PRIM  dabuggar  must  ba  usad  to  "prass"  th*  consol* 
switch**.  Aftar  prassing  tha  load-card*  button  (ip^  u*ing  th*  dabuggar  to  sat  tha 
Indicator  namad  (ILOAO)^  th*  "Start*  button  will  b*  prassad  (with  th*  go-to  command.) 

tUrtk  (all  01000*4*  (adsr  Sslnf)  Xaeula  *** 

#S*i  ClJOAD^f 

aC*  (la)  ** 

— > 3rsak  allar  aMaMilny  31S*Si  Jk  33633,33  aDtbrsak  ((raal  •4e  an 
Icanllral*^ 

§ 

Th*  braakpoint  was  ramovad  (with  tha  dabraak  command)  prior  to  saving  th*  stat*  of  th* 
amulation  so  that  it  could  not  intarfar*  with  any  futur*  us*  of  th*  savad  sassion.  Not*  on 
th*  last  lino  that  th*  dafault  of  ramoving  M braak*  raquirad  th*  aaaapa  charactar  and  a 
confirmationi  this  is  to  pravant  inadvartant  ramovsl  of  braakpoint*. 

An  arbitrary  amount  of  procassing  could  occur  at  tMs  point,  with  tha  sassion  baing 
Intarruplad  at  any  convanlant  point  to  ba  savad  and  rastorad  at  a latar  tima.  In  ordar  to 
sav*  tha  aaaalors  control  first  must  raturn  to  tha  PRIM  axac. 
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tRmtvm  (t*  EXEC) 

>5^**VE  T On*  •<  tha  falloMlngi 
[ M.L 

CONFISUMTION 

HEINWY 

''  SVIWOLt 

>3ftVE  (on  (llo)  l4t-7 IJjOADED; 

>Q*‘»un 

Oul«tln«  U1M«  ICenlIrttI 

a 

The  save  command  permita  tha  utar  to  aava  juat  tha  U1050  ayatam  configuration,  juat  tha 
UiOSO  mamory,  Juat  uaar  aymtx>i  tablaa,  or  all  of  thaaa  along  with  whatavar  a<iditional 
information  la  raquirad  to  nmetly  raaatabliah  tha  than-currant  altuation  at  a latar  time.  (It 
ahould  ba  notad,  howavar,  that  tha  contanta  of  filaa  ara  not  aavad,  ao  that  if  a road/write 
fila  on  aoma  davica  la  changed  aubaaquantly,  then  whan  a aava-all  la  raatorad  tha  atata  of 
tha  total  ayatam  cannot  ba  aaaeify  racraatad.)  Although  a aava-mamory  would  ba 
a<faquata  at  thia  point  for  moat  purpoaaa,  a aava-all  waa  performed  onto  tha  fila 
148-71. LOADED  ao  that  axiatint  I/O  conditiona  would  ba  raaatabliahad  on  aubaaquant 
raatoraa.  A aava-all  taKaa  more  time  to  aava  and  raatora  than  doaa  a aava-mamory  and 
alao  raaulta  in  a much  larger  fila,  ao  aava-all  ahould  ba  uaed  only  where  it  la  nacaaaary  to 
capture  tha  internal  atata  of  the  CPU  and  paripharaia.  Tha  aava-all  commarKi  can  ba 
aapaciaily  uaafui  whan  a program  error  raquiraa  a great  deal  of  procaaaing  to  occur 
before  it  appaara.  By  aaving  tha  aaaaion  ahortly  before  tha  error  occura,  the  error 
cortdition  can  ba  racraatad  quicMy  and  aaaily.  Ouitting  tha  PRIM  axac  returned  control  to 
the  TENEX  exec.  | 

At  aome  arbitrary  latar  time  tha  uaar  can  again  run  tha  UIOSO  emulator  arKi  i 

continue  a aaved  aeaaion  where  ha  left  off  at  tha  time  it  waa  aavad.  Thia  will  be  ahown  | 

uaing  the  reatore  command,  completing  tha  aacond  example.  ] 

a<Pltflf«M»a«i|;iaaeM«.sav,  % w | 

UlfM  ( 4m/7Tl  I 

>RBS**^yon  (IrM  SAVE  Ilia)  148-7 l.LOADBD; 

raatorinq  M.L  fraa  TUE8MY,  FEIMNMY  22,  1977  niS7il6-aST  ; 

>M*«ILESTaTUS  (for  a«vle«)  K^MEROER 
RMorX  Typa  gyta/Laat  FlU  Naa*  Oavic* 

•a  Binl2  B2aa/»2U  Ua-71.CR0t  1 REROER 

>J)*meim 
«T\iaa  OLDCQODB' 

OLOcci  aiaea  cci  assFa  » 

After  tha  raatora  of  the  aave-all  from  fila  148-71. LOADED,  tha  filaatatua  diapiay  ahovred 
that  the  card  deck  had  already  bean  read  la  Note  on  tha  fifth  line  that  whan  the 
filaatatua  diapiay  waa  raquaatad  for  a apacifk  davica  (in  thia  caaa,  tha  reader)  ackNtional 
information  waa  aupplie<i,  auch  aa  the  file  type  (binary  with  12-bit  bytea)^  and  the  current 
and  laat  byte  poaition  of  tha  filai  tha  activity  atatua  alao  appaara  whan  a device  ia  active. 

After  the  PRIM  debugger  waa  called  in,  OLDCC  and  GC  ware  diaplayed,  ahowing  that  the 
leat  irwtruction  had  executed  out  of  location  01000  and  tha  next  one  waa  to  be  executed 
out  of  location  03570.  At  thia  point  the  aaaaion  can  ba  continued  aa  If  it  had  never  been 
Interrupted. 

The  remaining  examplaa  wili  be  much  briefer  than  thoaa  preaented  above.  Inatead 
of  cemplote  aequencea  of  Interaction  with  an  actual  program,  Juat  thoae  commenda  that  are 

j 
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neceeear/  to  solve  particular  problems  will  be  showa  In  a tow  cases  intervening 
interections  have  been  edited  out  of  the  transcript  to  emphasize  the  essential  commands. 
In  general,  results  will  not  be  showa 

FIND  WHICH  INSTRUCTIONS  MODIFY  A LOCATION 

A typical  debugging  problem  is  to  find  what  instructions  are  changing  a location 
(e.g.,  some  module  is  clobbering  a parameter).  This  can  be  solved  vary  easily  with  a 
simple  breaK-time  debugger  "program”.  If  the  contents  of  location  012345  are  being 
changed  (snd  should  not  be),  the  following  breakpoint  command  will  identify  the  culprit. 

#Br«ak  (at)  0tU4S*^  (aftar  dolns)  IFrIta 
«#JfMla  Inalruetlan  fZZTuaa  UOLKCfif 
ZiTya*  0i234S«r 

#4Ce  (to)  ^ 
ttcr 

<Prafraa  nuabar  la  tll>  # 

After  every  write  reference  to  location  012345,  program  execution  will  be  interrupted  and 
control  will  be  passed  to  the  debugger,  which  will  execute  the  break-time  commands  to 
display  the  instruction  that  just  executed  snd  to  display  location  012345.  In  this  example 
the  program  would  continue  automatically  after  each  break.  If  only  the  first  breakpoint 
suboMnmand  had  been  entered  (eliminating  the  type-out  of  012345  and  the  go  commands 
on  the  third  and  fourth  lines)^  then  after  displaying  the  last  instruction  executed,  the 
debugger  would  display  location  012345  (with  its  new  contents)  and  pass  control  to  the 
user. 

FIND  WHICH  INSTRUCTION  SETS  A LOCATION  TO  A VALUE 

A related,  and  perhaps  even  more  common,  problem  is  to  find  what  instruction  is 
setting  an  improper  value  into  some  location.  This  can  be  accomplished  with  a variant  of 
the  break-time  debugger  "program*  presented  above. 

#£r«ak  fat)  01234$**^  (altar  Salny)  IFrlta 
itit  901234S  o 067«w  <ihan>  ffSCo  (to)  » 

##MoSa  /nstruetlon  ***  90LDC0^ 

tter 

<rrayraa  nuabar  la  (21  > # 

The  important  things  to  note  about  this  example  are  the  use  of  a conditional  debugger 
commend  (if)  and  the  "contents-of"  operator  (c»X  The  first  breakpoint  subcommand  states, 
in  essence,  "if  the  contents  of  location  012345  are  not  equal  to  the  value  067  then 
continue  executiont  " the  second  subcommand  states,  "otherwise  display  the  lest  instruction 
executed  and  break."  The  symbol-pair  "o"  represents  "not  equal  to"  (literally,  "less  or 
greater"!  Mfhen  the  program  breaks,  the  offending  instruction  will  have  been  discovered. 


DETERMINE  HOW  MANY  TIMES  A CODE  SEQUENCE  IS  ENTERED 


Occasionally  the  efficiency  of  a program  system  is  degraded  by  unnecessary  end 
unexpected  calls  on  subroutines  that  do  initialization  or  other  operations  whose  repitition 
do  not  cause  errors  but  do  affect  performance.  The  PRIM  debugger  can  be  used  to  count 
the  number  of  times  a code  sequence  is  entered.  In  the  following  example  the  coda 
sequence  Is  assumed  to  start  at  location  01234,  and  location  076000  (which  is  assumed  to 
be  unueed)  Is  used  as  a counter. 
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iCiMT  0760000' 

tBrtlk  tat)  01134**0  (altar  deliif)  Xaeuta  *** 

ttSmX  076000**o  . 9076000*1*0 

##ruM  076000*0 
MiCo  (ta)  00 
4000 

<Prafraa  nuaaar  ia  191 » 0 

Ev*ry  tint*  location  01234  it  antarad,  th*  count  will  ba  incramantad  and  ditplayad.  M only 
a final  count  la  desirad,  rathar  than  a running  count  of  aach  oxacution,  tha  following 
command  could  ba  used: 
fClaar  076000*0 

#Jfraak  tat)  01234***  (attar  aaln«)  Xacuta  *** 

M$at  076000***  • 076000*1*0 
f#Ca  (ta)  *0 
00*0 

<ara9raa  iMMbar  la  (41  > 0 

a a a 

#ruaa  076000*0 

COUNT  REFERENCES  PRIOR  TO  A DESIGNATED  CONDITION 

The  afficiency  of  a procata  can  aomatimaa  ba  avaluatad  by  tha  number  of  timaa  a 
^ data  location  ia  rafarancad  prior  to  tha  occurranca  of  a givan  condition  of  intaraat.  A 

L I variant  of  tha  pravioua  axampla  can  ba  uaad  whara  tha  automatic  continuation  ia 

I conditional  on  th*  dasignatad  condition  not  yat  having  occurrad 

iCtaar  076000*0 

0Brt»i  (at)  0H34S***  (attar  aalny)  Aaatf  IFrita  *** 
ffSat  076000***  - 9076000*1*0 
00h  95432  O 0***  <than>  000G*  (ta)  ** 

00*0 

<ara9raa  iMNOar  la  Kl>  0 

a a a 

076000*0 

Whan  tha  condition  that  location  05432  containa  a zero  occura,  th*  program  oxacution  will 
braah  and  th*  counter  can  ba  axaminad 

TRACE  A LOOP  ONLY  ONCE 

With  tha  PRIM  dabuggar,  a program  trace  ia  accompliahad  by  aatting  an  axacuta 
braak  on  ail  inatructiona  of  intaraat  and  aupplying  a braaK-tima  dabuggar  program  that 
diaplay*  tha  moat  recant  inatruction  to  axacuta  (aa*  tha  dataiiad  axampla  on  antaring  and 
debugging  a email  program^  To  trace  tha  loop  only  once,  th*  automatic  continuation  ia 
mad*  conditional  on  CC  not  being  equal  to  th*  atarting  location  of  tha  traca. 

#JlrMk  (at)  07234:02345***  (a(««r  aelny)  Xaewt*  *** 

00M*4t  /natruellM  ***  ffjTga*  90LDCC4O 
00h  90C  o 01234***  <thm>  000C*  ((•)  *0 
00*0 

<fr«yra*  maPar  la  (Cl>  0 

To  traca  th*  loop  a timaa.  tha  continue  could  b*  made  conditional  on  a counter  that  la 
incramantad  whenever  th*  atarting  kKation  ia  raantarad  If  a continuoua  traca  la  daalrad, 
tha  break  can  ba  antarad  for  th*  event  STKP  and  th*  go>to  command  can  b* 
unconditionalt  a tX  abort  intarvantion  would  b*  required  to  atop  auch  a trace. 

f 

I, 
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DETERMINE  WHICH  INSTRUCTIONS  WERE  NOT  EXECUTED 

An  unucuel  use  of  the  PRIM  debugger  is  to  determine  whet  instructions  were  neeer 
executed  while  running  some  program.  This  can  be  eccomplished  quite  eeaily  by  eetting 
breekpoints  throughout  the  area  of  interest  end  then  having  each  eeecute-breeh  remove 
its  own  breehpoint. 

#Dsbre«K  (frse)  •Man  Ceenllrei*'’ 

§Brtk  (at)  dllJ4.*05670**c  (aflar  aoinf)  Xaevta  *** 

MDabreaS  (free)  mOUXXiiOLOCC*4l» 
ttC*  (te) 

<krayraB  nuahar  la  (7)>  fllraak  (at)  0S67S***  (attar  ealaf)  Xeaete 
iC*  (ta) 


-~>  Iraat  altar  anaeutlnf  aSSTii  J §Br*tk  (at)  ^ 

•34Sa-a4U7  <X-f71  aSSTC  <x>  # 

At  the  end  of  the  program,  a dtspiay  of  the  breakpoint  data  baae  shows  thoee  locations 
that  were  never  executed.  Note  that  when  an  execute  breakpoint  is  specified  over  e 
range  of  iocations  it  is  detected  only  for  the  location  containing  the  opcode  portion  of  the 
instruction,  so  on  each  execution  it  Is  necessary  to  remove  the  breakpoints  for  all  five 
instruction  locations.  Note  also  on  the  sixth  line  that  even  though  all  existing  breakpoints 
had  been  delated  by  the  command  on  the  first  line,  the  new  break-time  program  program 
was  assigned  (he  next  higher  sequence  number  <in  fact,  break-time  program  are  never 
deleted,  so  that  they  may  be  reused  at  a later  time  without  having  to  reenter  them). 

DETERMINE  WHEN  DATA  CHANCE  OVER  A CODE  SEQUENCE 

It  is  occasionally  necessary  to  determine  whether  a code  sequence  has  changed  the 
value  in  soma  locatioa  This  can  be  done  by  setting  a breakpoint  at  the  beginning  of  the 
sequerKO,  where  the  break-time  commands  copy  the  data  value  into  an  unused  location, 
and  setting  another  breakpoint  at  the  end  of  the  sequence,  where  the  break-time 
commands  compare  the  copied  value  with  the  current  value.  In  the  following  example,  the 
code  sequence  starts  at  012345  and  ends  at  023456,  the  critical  location  is  at  05432,  and 
076000  (assumed  to  be  unused  here)  is  used  for  temporary  storage. 

#Jlrsas  (at)  011345**^  (altar  aaliq)  Xacuta  **** 

««Sat  076000^  . 

/«Ca  (ta)  ^ 

<krafraa  mm>ar  Is  (M>  #RraaS  (at)  013456**^  (altar  doliq)  Xaeuta 
##/l  •0S433-m076000Me  <tl«aii>  M«Ca  (ta) 

a®*’ 

cPratrae  miaSar  Is  (•)>  f 

Each  time  the  value  in  05432  changes  over  the  designate  code  sequence,  program 
execution  will  break. 


SEARCH  A BUFFER  FOR  A GIVEN  VALUE 

The  final  example  will  show  how  to  search  a buffer  (or  any  arbitrary  set  of 
locatione)  for  the  occurrence  (or  nonoccurrence)  of  a designated  value.  In  this  example, 
all  values  other  then  3 in  the  left  half  of  a word  are  to  be  found. 


'tiiiliiliil'tilliililiiM  iifUirti  afeMilMlMMUfr  %irilir1i[llM>'liiMi»irii'<itiA>aBui(Pfc<ftB^  Ir'rVifirtYMIlilltilliWiaiUv^a  ftin 
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NON 929^  (with  MM)  070«M  (in)  0l9590t*9» 

* 

Tha  ganaral  form  of  tho  locata  command  raquira*  a compariaon  valua,  a mask,  and  a aot  of 
addroaaos  to  OKamina.  Tha  compariaon  valua  and  maaK  can  aach  bo  any  arbitrary 
axpraaaion.  Tha  cat  of  addraacaa  can  ba  a Hot  of  diacrata  locationa  or  addf^aa  rangaa. 
By  antaring  NON  bafora  tha  compariaon  valua,  ita  nonoccurronca  it  raguirod.  Tho 
compariaon  vaiua  dafatHta  to  ”N0N  0*  and  tha  macK  dofaulta  to  *N0T  0*  (U.,  all  1 bita). 
Tha  taat  ia  parformad  by  comparing  tha  eontanta  of  aach  daaignatad  location  with  tha 
alignod  compariaon  valua  aaly  /ar  iAom  hU$  wiUra  like  mlignti  moafc  Ut  ia  a ana.  K all 
auch  bita  compara,  than  a match  haa  occurred)  if  any  cuch  bit  diffora,  than  a failura  haa 
occurred.  Tha  location  in  quaation  ia  than  diaplayad  or  not  according  to  whathar  a match 
or  non-match  waa  apacifiad.  Tha  locata  command  it  analogoua  to  tha  typo  command  in 
that  if  it  ia  tarminatad  by  an  acMpa  a rapiacamant  valua  can  ba  antorad  for  aach  diaplayad 
location.  The  aama  rules  for  the  rapiacamant  value  apply  for  locata-with-raplacamant  as 
for  typa-with-raplacamant. 
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APPENDIX  At  UIWO  FEATURES 


Mamory  Addratcat: 


AddraM  of  ImI  call  ditplayad  in  tha  form  "addratK 
Fiva-byta  call  starting  at  addrass  a,  whara  a is  ass 
Tatrad  a,  whara  a is  octal  or  daeimal. 
Indax-ragistar  a. 


assumad  octal 


Puahbuttons: 

S. CtEAR  Systam-claar  pushbutton. 

T. LOAO  Load-from-tapa  pushbutton. 

C.LOAO  Load-from-card-raadar  pushbuttoa 

GCXM  Naxt-instruction-from>M  pushbutton. 

GD.OC  Naxt-instruction-from'OC  pushbuttoa 

OPJtEQ  Oparator-raquast  pushbuttoa 

Control  Countars: 

OLOCC  Ragistar  containing  addrass  of  last  instruction  axacutad. 

CC  Ragistar  containing  addrass  of  naxt  instruction  to  ba  axacutad 


Indicators: 

INDa 

Tastabla-indicator  a,  whara  a is  octal  with  no  loading  xaro. 

KNO 

IN040. 

m 

IN041. 

KEQ 

IND42. 

KUQ 

IND43. 

KLO 

IND44. 

AZ 

IN045. 

AN 

IN046. 

NBOF 

IND47. 

OOF 

IN050. 

lOSI 

IND63. 

NW2 

IND64. 

I0S3 

IN055. 

KBNT 

IND66. 

IRPor  OS2 

iND67. 

INHl 

IN061. 

SSI 

IN062. 

SS2 

IN063. 

SS3 

IN064. 

Sll 

IND6S. 

SI2 

IN066. 

SO 

IN067. 

Tl 

IN071. 

m 

IND72. 

CHMDSji 

l/O-indicator-bits  for  channal  a 

Ciass-l-intarrupt-inNbit  flop. 

02 

aass>2-intarrupt-inhibit  flop. 

03 

Class-3-intarrupt-inNbit  flo^ 

'I 
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MiMeilaneoue: 

UAY.CLOCK 

Operators: 

XOR 

OR 

AND 

NOT 


Constants: 

Octal 

Decimal 

XS3 

String 

BrasK  Events: 
000 
PUT 
JUMPS 
DROP 
STEP 
K) 

INT 

TCK 


Page  16 


Day-time-clock  (6  bytes). 


Exclusive-OR  binary  operator. 
inclusive>OR  binary  operator. 

Logical-AND  binary  operator. 

Logical-NOT  unary  operator. 

Not-equal-to  binary  relatiorwhiop. 

Less-than-or-equal-to  binary  relationship. 
Graater-than-or-equal>to  binary  ralationsNp. 

Less-than  binary  relatiorMhip. 

Greater-than  binary  relatiorwhip. 

Equal-to  binary  relationship. 

Plus  binary  operator  or  Increment  unary  operator. 

Minus  binary  operator  or  Negation  unary  operator. 

Modulus  (integer  remainder  on  division)  binery  operator. 
Multiplied-by  binary  operator. 

Divided'by  binary  operator. 

Absolute  unary  operator  (NB.  U1050  arithmetic  Is  unsigned). 
Left-bracketer. 

Right -bracketer. 

Contents-of  unary  operator. 


Digits  0-7,  mandatory  leading  zero 
Digits  0-9,  no  leading  zero 

Prime-text-prime  (XS3  characters  converted  to  binery  end  trunceted) 
Quote-delimiter-text-delimiter  (as  in  multi-word  string 


Break-on-every-anomaly  debug-switch. 
Break-on-every-store  debug-switch. 
Break-on-every-jump  debug-switch. 
Break-on-every-conditional-iump-that-falls  debug-switch. 
Break-on-every-irwtruction-execution  debug-switch 
Break-on-every-l/O-activity  debug-switch. 
Break-on-every-interrupt  debug-switch. 
Break-on-every-clock-tick  debug-switch. 


Optional  Anomaly  Conditions  (requested  by  ODD  event): 
Card  Punch  Feed-read 
Card  Reader  72-column  Select 
Device  Not  Ready 
Disk  Anomsiy  (b^  (unction  bits) 

EOF  Encountered  in  Communications  Input 

I/O  Overlap 

I/O  Overload 

I/O  to  Low  Memory 

l^mory  Exceeded 

Nonexiatent  Controller 
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Printer  132’COiumn  Select 
Tape  Anomaly  (bad  function  bits) 
Too  Many  Product  Bytea 


Automatic  Event  Stopss 

Halt-display  Instruction 
Hunt  on  Qass-l  Interrupt 
Hunt  on  Divide 

Internal  (emulator)  I/O  Synchronization  Error 
Program  Halt 

Ona-shot  Error  (no  room  for  installation) 
Uhimplamented  Instruction 


Available  Devices: 
Printer: 

Reader 

^jnch 

Disk 

Tape 

LS-comm. 

HS-commu 

aocK 

Memory 


XS3  translated  to  ASC» 

Speed  parameter,  defaults  to  922  lines/  min. 

12-bit  binary,  or  ASCII  translated  to  18^26  column-binary 
Speed  parameter,  defaults  to  600  csrds/min. 

12-bit  binary,  or  eM026  column-binary  translated  to  AS(!N 

Speed  parameter,  defaults  to  300  cardb/miru 

Binary 

Binary  (or  physical  mag  tape  unit) 

Speed  parameter,  defaults  to  3 min./2400-foot-rewind 

USAF6  translated  to/from  ASCII 

Speed  parameter,  defaults  to  10  char./sec. 

ASCII  (with  bits  7 and  8 inverted)  trsnsisted  to/from  ASCN 
Speed  parameter,  defaults  to  240  char./sec. 

XS3 

Rate  parameter,  defaults  to  1 tick/sec. 

Size  parameter,  defaults  to  eight  4192-word  modules 
Cycle-time  parameter,  defaults  to  4500  nanoseconds 


i 
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APPENDIX  Bt  UlOM  CONPICURATION  PARAMETERS 


Memory  Iker  eettebie  speed  parameter,  defaults  to  4500  nanosocond  (nsec) 
cycie-timet  can  be  set  with  a precision  of  50  nsec.  User  settable  size 
parameter,  defaults  to  eight  4192''byte  modules. 

CPU  Instruction  timing  Is  based  on  Univec  Manual  UP-3912  (Revision  1)^  Section  3, 

page  73.  Timing  is  implemented  as  follows:  (1)  instruction  fetches  occur  at 
memory  speed;  (2)  indexing  taKes  three  additional  memory  cycles;  (3)  memory 
reads/writes  by  an  instruction  occur  at  memory  speed;  (4)  any  remaining  time 
Is  divided  by  4ii  microseconds  (usee)  to  convert  it  to  a corresponding  number 
of  memory  cycles  (and  cause  it  to  speed  up  or  slow  down  proportional  to 
memory  speed). 

Printer  User  settable  parameter  at  installation  time,  defaults  to  922  lines  per  minute. 

Reader  User  settable  parameter  at  installation  time,  defaults  to  600  cards  per  minute. 

! Punch  User  settable  parameter  at  installation  time,  defaults  to  300  cards  per  minute. 

LS-comm  User  settable  parameter  at  installation  time,  defaults  to  10  characters  per 
second.  Remote  echo  delay  of  one  half  a character  time  is  provided.  Up  to 
16  comm  units  (LS  or  HS  in  any  mix)  can  be  installed. 

HS-comm  User  settable  parameter  at  installation  time,  defaults  to  240  characters  per 
second.  Remote  acknowledgments  occur  after  three  character  times.  Up  to 
16  comm  units  (LS  or  HS  in  any  mix)  can  be  Installed. 

Disk  Characteristics  cannot  be  changed  parametrically.  Maximum  disk  address  is 

01453777.  Disk  timing  is  based  on  the  following  model:  (1)  one  cylinder 
contains  64  sectors  for  16  heads;  (2)  sectors  of  168  bytes  are  interlaced  on 
the  disk  in  two  cycles  such  that  successively  addressed  sectors  are  separated 
by  one  sector  from  the  other  interlace  cycle;  (3)  sector  0 on  a cylinder  starts 
• just  past  the  index  point,  and  sector  32  arrives  6.267  ir-Mseconds  (msec)  later; 

(4)  one  disk  revolution  takes  25  msec;  (5)  head  positioning  takes  10  msec  for 
the  first  cylinder  crossed  and  111  usee  for  each  successive  cylinder; 
(6)  transfer  rate  is  4 usee  per  byte.  All  timing  is  computed  to  a precision  of 
50  nsec. 

Tape  User-settable  parameter  at  installation  time,  defaults  to  3 minutes  to  rewind  a 

2400-foot  reel.  Other  timing  characteristics  cannot  be  changed 
t parametrically.  Tape  timing  is  based  on  the  following  model:  (1)  all  tape 

records  are  one  of  two  sizes,  either  256  bytes  or  3072  bytes;  (2)  reads  or 
writes  from  load  point  take  an  extra  85  msec;  (3)  start-up  of  a read  or  write 
takes  10  msec  if  the  last  order  completed  more  than  41  usee  ago;  (4)  large 
block  reads  or  writes  take  129.396  msec,  small  blocks  take  10.783  msec; 

(5)  deceleration  from  a read  or  write  takes  5 msec;  (6)  large  block 

I backspacing  takes  144.496  msec,  small  blocks  taka  25.833  msec,  but  only  the 

size  of  the  last  block  read  or  written  is  remembered  for  timing  purposes. 
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INTRODUCTION 

1Ns  docufncnt  is  the  common  reference  manual  for  all  users  of  flic  PI^M  system, 
Itolh  those  usirtg  one  of  the  existing  emulation  tools  and  those  writinc  rM>w  emulalors.  I or 
tho  former,  this  manual  is  supplemented  by  the  appropriate  tool-specific  p.iiide  PHIM 
System:  UtOSO  User  Cuufa)i  for  the  emulator  writer,  the  supplement  is  PRIM  System:  1 ool 
lUtildcr  Menuat 

The  PHIM  system  is  always  in  one  of  three  states,  Known  Ihe  cyei,  ll»c  debup.p.rr, 
aiKl  the  target  execution  states,  the  transition  between  slates  is  rtmlrolled  by  the  user, 
noth  of  the  first  two  stales  are  PRIM  command  processors  th.it  lake  commands  from  llic 
user  and  execute  them,  the  exec,  whose  commarrd  prompt  rli.irarirr  is  is  used 
prifKipally  for  setting  up  a target  environment;  the  debugger,  whose  command  prompt  is 
"a",  is  used  for  the  detailed  examination  and  control  of  thi'  cxeruting  target 
mncNne.  Target  execution  includes  the  emulation  of  not  only  the  CPU,  but  also  clocKs  atrd 
assorted  peripheral  10  devices.  7he  three  sections  following  the  introduction  cirscribc 
each  of  the  states  in  tura 

The  PRIM  exec  atrd  debugger  commands  are  illustrated  with  examples  laKcn  from 
a<  luaf  session  transcripts,  in  all  the  examples,  user  input  is  itelirisrJ  to  distirrguish  it 
from  PRIM  output.  Input  control  characters  appear  as  their  abbreviations  superscripted 
(e.p., «»«“). 


CSNIRAL  INPUT  CONVENTIONS 

User  input  to  PRIM,  both  exec  and  debugger,  is  generally  free-formal  and 
casc-irKfepertdent.  Lcadirrg  spaces  and  tabs  are  ignored,  and  lower  <.ise  is  treated  as  its 
upper  case  equivaleni  (except  in  quoted  strings,  where  case  is  potentially  significant). 
Ihcr  input  to  the  target  machine  during  target  execution  slate  is  in  tlir  format  required  by 
the  target  system. 

Certain  characters  have  been  assigned  editing  and  intervention  luiKtionr.  when  input 
by  the  user.  1he  editing  characters  apply  only  to  the  PRIM  exec  and  debugger,  while  the 
intervention  characters  apply  to  the  target  execution  slate  as  well.  Ihe  specific 
characters  assigrwd  to  most  of  Ihe  functions  may  be  altered  (via  Ihe  exec  Change 
command)  to  suit  one’s  needs.  Ihe  editing  functions  arc  valid  at  any  time  during  IMtlM 
command  input;  commands  are  not  executed  until  after  the  final  character  has  been 
accepted. 

Maeft-apeee  (cnll*H)  erases  a character  Irom  Ihe  current  word  or  term  of  input.  1lic 
back-space  is  echoed  as  a backslash  (\)  followed  by  the  erased  character.  When 
lliera  are  no  erasable  characters,  a bell  (cntl-G)  is  echoed  inste.-id. 

Altermmte  Aeeb-apaee  (initially  cntl-A)  performs  a function  identical  to  bark-apere;  it  is 
provided  as  a conveniefKe. 
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IHtirktip  (initially  cnII-W)  erases  the  current  word  or  term  of  input.  It  is  echoed  as 
backslash  (\)  followed  by  the  first  character  of  the  erased  word. 

Krtype  (initially  cntl-R)  retypes  the  current  input  line;  it  is  useful  after  a confusing 
amount  of  editing  has  occurred. 

I IMric  (initially  DEL  or  RUBOUl ) aborts  the  current  input  command  or  subcommand, 

[ allowing  the  user  to  re-enter  it.  tt  is  echoed  as  " XXX". 

; Qtn‘»tinn  (?),  when  entered  at  the  beginning  of  a command  field,  elicits  a description  of 

^ Iho  expected  input,  followed  by  a retype  of  the  line.  When  the  expected  input  is  a 

selection  from  a list  (or  menu),  the  entire  fist  is  shown. 

i 

Ihc  intervention  characters  are  valid  at  any  time,  including  command  input,  command 
interpretation,  and  target  execution. 

(initially  cnfl-X)  interrupts  the  current  activity  and  returns  control  to  the 
command  levet  of  either  exec  or  debugger.  When  used  to  cancel  an  exec  or  debugger 
command,  control  returns  to  the  top  levet  of  the  same  state;  abort  is  the  onty  means  of 
carKcling  a commarrd  when  the  user  is  in  subcommand  mode.  When  used  to  interrupt 
target  execution,  control  returns  to  the  state  from  which  execution  was  initiated;  abort 
is  Ihc  only  means  of  stopping  a looping  target  machine. 

Sittin*  (initially  cnII-S)  produces  a one-fine  summary  of  target  machine  status,  inctuding 
program  counter,  emulated  elapsed  time,  and  active  10  devices.  Ihe  command  is  valid 
L'  at  any  time,  but  useful  primarily  in  execution  state. 

\i 

Ihc  following  character  is  active  only  during  target  execution. 

[t  (loHirol-thifi  (initially  cnll-1)  permits  the  user  to  cnier  (during  execution)  a control 

I code  that  canrrol  be  entered  directly  because  it  is  intercepted  by  cither  PRIM  or  the 

operating  system;  fhe  PRIM  characters  inolved  are  Monix,  ofmri,  and  ronirol-thifi  itself. 
Ihc  next  ASCII  character  following  the  eonirol-thi/i  (other  than  Ihc  digits  0 thru  9)  has 
its  two  leading  bits  cleared,  thus  converting  it  to  an  ASCII  control  code  (/I  or  n to 

I rni/-/),  etc.).  Conirol-nhift  followed  by  a digit  results  in  an  input  that  is  outside 

the  normal  target  character  set  and  is  used  for  particular  tar  gel-machine-dependent 
furKtions.  1hc  control-shift  character  itself  is  not  echoed,  and  not  passed  to  the 
f target  machine.  If  execution  terminates  before  that  next  character  is  input  to  the 

target  device,  the  control-shift  is  canceled;  it  is  not  retained  for  the  next  resumption  of 
' execution. 
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PRIM  EXEC 


1he  PRIM  exec  la  the  Initiel  stale  of  a PRIM  tession.  Lxcc  commends  ern  concerned 
primarily  with  building  lergol  configurations,  saving  PRIM  session  results,  restoring 
previously  saved  sessions,  and  accessing  or  cresting  files  (within  the  file  space  of  the  host 
operating  system). 


Ilie  exec  prompt  character  Is  Indicating  that  PRIM  is  in  cxec  stale  and  that  the 
cxec  is  awaiting  a now  commarKii  it  is  always  shown  on  a new  line.  Individual  input  fields 
consist  of  Keywords  (a  word  selected  from  a menu),  decimal  numbers,  and  file  names. 
I Koc  commands  are  composed  of  fixed  sequences  of  fields,  each  terminated  by  a delimiter 
cliaracteri  a final  confirmation  consisting  of  a raiurn  is  often  required. 


Keywords  are  selected  by  any  unambiguous  leading  substring.  Ollen,  a single 
character  suffices;  three  characters  are  always  sufficient.  Numbers  aro  specified  in  their 
entirety.  MIo  names  are  specified  according  to  the  conventions  of  the  operating  system. 
All  commands  that  will  use  a file  for  output  require  the  name  of  a new  file  (except  the 
Muunl-Append  and  Mount-Old  commands,  which  modify  existing  filer.);  all  other  file 
commands  require  the  name  of  an  existing  file.  In  ItNfX,  an  existing  file  name  ■ and  a 
nc'W  file  ftiat  is  a new  version  of  an  existing  file  name  --  is  recognired  (and  compleled)  in 
rc'sponse  to  an  input  nxrApe. 


liie  normal  delimiters  that  terminate  command  fields  are  reiwrw,  mrtfftc,  and  */>ore. 
and  a/mre  function  Identically  except  that  the  former  generates  leedbacK  to  thr? 
U'.t  r while  the  latter  generates  none;  the  feedback  produced  by  e.«c**pa  itu hides  both  field 
(umplclion  and  next -field  prompting  (which  is  given  in  parenthev^s).  liriurn  is  used  lo 
romfslclc  a command  immedialely,  bypassing  any  remaining  fields  and  conlirmalion;  If 
further  input  is  required,  the  raiurn  is  treated  as  an  aurnpa.  (In  the  examples  that  follow, 
e.rrn/ta  termination  is  used  to  show  the  prompts.) 


Keywords  that  Involve  either  devices  or  parameters  are  mathine-depcndenl;  the 
selcclions  shown  In  the  examples  are  meant  to  be  illustrative  ralher  Hum  detinillve. 
Dr'vicc  specification  Is  further  complicated  when  two  (or  more)  of  the  same  generic  devire 
are  installed,  therefore,  for  device  names,  two  further  delimiters  are  ulili?ed,  ni  ("»•'")  and 
ro/an  (":").  A fully  qualified  device  name  consists  of  gearrir-nama  »»  etmiinel-mirntirr  ; 
tnih  numhrn  the  numbers  aro  required  only  to  the  extent  necessary  lo  sf>ecily  a 
particular  device.  When  a device  name  Is  terminated  by  one  of  the  standard  terminalors, 
and  when  further  disambiguation  is  required,  the  exec  prompts  explicitly  regardless  of  the 
li  rminator. 


tiio  remainder  of  this  section  consists  of  the  descriptions  of  the  exec  commands  in 
alphabetical  order,  tach  command  description  begins  with  a transcript  showing  one  or 
more  examples  of  the  command  and  Its  various  options.  Ihose  commands  that  require  a 
second  Keyword  sirow  that  list  via  an  input  quatifon.  Iho  cxec  commands  are: 


E 
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>f  One  al  the  IslloMlnfi 
CRNCtL 
CHflNGf 
CLOSE 
CONIWNDS 
OLBUC 
FILESTOTUS 
CO 

INSTM.I 

MOUNT 

NEUS 

PERIPHERALS 

QUIT 

REASSIGN 

Rl STORE 

REUINO 

SAVE 

SIT 

SHOU 

SYMBOLS 

TIME 

TRANSCRIPT 

UNINSTALL 

UNMOUNT 

> 

Comment. 

>;  thi»  lino  « eommanl'”' 

> 

Any  line  beginning  with  a »t>mir.plon  is  treated  as  a comment.  Comments  are  recorded  in 
the  transcript  if  one  is  open  (see  Iranscript  command). 

CaiKef  abandons  ail  outstanding  fO  operations  for  a designated  device. 

>r««’*<^CL  (10  lor  tfovico)  lo<*««PC-UNIT 
> 

Ihis  command  is  intended  for  use  when,  after  an  K)  error  halt  (described  in  the  section  on 
target  eMecution),  the  user  wishes  to  abandon  the  device  operation  rather  than  nK>unt  a 
file  and  retry  the  operatioa  The  list  of  outstanding  K)  operations,  by  device,  ts  part  of 
tho  Peripherals  command  output. 


J 


j 


) 


PUIM  System:  LMcr  Reference  Manual 
Ixcc 


Page  5 


Channe  reassigns  (he  PRIM  control  functions. 

>rA*’^^(IN6C  (IneuI  ee<l«  (or)  f On*  of  Ih*  l•IIOMln9l 
nnoMT 

RLT-OnCKSPRCC 
oncKup 
Of  LEU 

act  WE 
sintus 

CONTROL -Sllirt 

>CHOHCC  f Input  cod*  tor)  •A«**<'0RT  (Iroa  « tol  f R Contr*!  Cod*. 

>CHflNGF  (Input  cod*  tori  WORT  (troM  tX  t*> 

(Input  cod*  (or!  cf^'^tlCTC  (fro*  <0CL>  toT  (not  chanqod) 

> 

This  command  allows  Iho  user  to  change  the  ASCII  control  code  assigned  to  any  of  the 
listed  PRIM  control  furKtions  from  its  current  assignment  to  another  (currently  unassigned) 
control  character.  The  function  name  is  the  second  word  of  the  command;  when  it  is 
terminated  with  an  enrape,  the  current  assignment  is  noted  In  the  noise.  Ihc  entire  set  of 
ASCIf  control  codes  (including  delete)  Is  available  excepting  null,  hnrk-*porr,  l*ne-/eed, 
rrturm,  eaeepe,  and  unfl'seperalor  (1ENEX  vnd-^f-liM)  which  have  fixed  functions  in 
PRIM.  For  ahort  and  aiolus  the  set  Is  limilod  to  cell-/!  thru  end-/. 


Close  terminates  the  current  transcript  file  if  one  Is  open. 

>rl*’*POSC  (transcript  III*.) 

> 

A transcript  file  is  opened  using  the  Transcript  command;  it  is  automatically  closed  at  the 
erfd  of  a session. 

Commands  redirects  subsequent  Input  from  a file. 

>roP*PminNns  (irom  III*)  rommend./lle‘’*T= 

> 

This  command  causes  PRIM  to  read  its  subsequent  command  input  from  the  named  file 
instead  of  the  user  terminal  (or  current  command  file).  The  file  input  is  treated  exactly  as 
terminal  input  except  that  intervention  functions  (aAori  and  aieiHx)  are  valid  only  from  the 
terminal.  Should  a command  in  the  file  cause  execution  to  be  resumed,  input  that  normally 
would  come  from  the  user  terminal  is  taken  Instead  from  the  file.  Input  reverts  to  the 
previous  source  at  Ihc  end  of  the  file;  an  aAort  terafiinatcs  all  command  files  and  reverts 
input  to  the  user  terminal.  Command  files  may  be  nested.  Command  files  are  very  useful 
for  common  session-initialization  sequences. 

pcbiig  transfers  control  to  the  PRIM  debugger. 

«r*(urn  (t*  EXIC)  " 


The  PRIM  debugger  is  described  in  the  next  section;  control  is  returned  to  the  exec  via  the 
debug  Return  command. 
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Filrstatus  returns  information  about  mounted  files  for  all  or  designated  devices. 

>/e*r|icsTnTUS  (for  a«vle«)  RIL 


Racerd 

FI  la  Nana 

Oovica 

17 

cnRo.occr 

CRRO-REROER 

12 

Tig 

PRINTER 

626 

It  RniNRl.  INPUT 

TERRINRL  (In) 

17346 

TIRN.OUT 

TtRNINm.  (Out) 

3«6 

nnco.EFc 

TRPE-UNITiS 

>/e«r|iFSTniUS  Clor  a«vte«>  C(|O*<^0-REM>Ea 
Racerd  T^p•  ayU/L«*l  FlU  N«m 

12  Plnl2  360/1281  CRRD.OECK 


> 

When  the  device  field  is  empty  (return  or  escape)  all  mounted  files  are  listedi  otherwise 
just  the  filo(s)  on  the  named  device  are  listed,  ihe  latter  case  gives  more  complete  status 
than  does  the  former.  1he  output  fields  are: 

Record  tells  the  current  position  of  the  device  or  the  number  of  records  which  have 
been  processed.  For  disKs,  it  is  a sector  number;  for  card  readers  and  purKhes,  a 
card  count;  for  communication  lines,  the  total  number  of  bytes  transferred;  for  mag 
tape  units,  the  position  from  beginning  of  tape  expressed  as  files  * records. 

File  Name  is  Ihe  name  of  the  file;  the  name  "User  Ity"  is  displayed  wlien 
TtilS-rKKAHN/lt.  is  the  file. 

Device  is  the  emulated  device  on  which  the  file  is  mounted. 

lype  describes  the  type  of  file,  either  Ascii  or  Uinxx,  where  xx  is  the  file  byte  size. 
Ihe  lype  may  have  been  explicitly  specified  at  mount  lime,  or  it  may  have  been 
a'.sumcd  by  PRIM. 

Dvte/Last  is,  for  a mounted  disk  file,  Ihe  current  byte  position  in  the  file  and  the  total 
number  of  bytes  in  the  file. 

The  marginal  rtotation  "Inol  operwdr  indicates  that  Ihe  named  file  could  not  be  found  (this 
occurs  only  to  a restored  file)  and  that  Ihe  device  must  be  reassigned  to  another  file  (or 
to  the  same  file  via  a new  path  name). 

Go  transfers  control  to  the  target  execution  stale. 

>^e«ro  (freu  17341 

nnCHINE  runninq  a«  6678,  Uiad  tiSI.S 
- » nnCMlNE  hatUd  at  6643,  Usad  titl.t 
> 

This  command  transfers  control  from  Ihe  F*RIM  exec  to  Ihe  emulator  or  target  machine,  in 
Its  current  stair.  Control  returns  to  the  exec  when  the  target  machine  halts  or  a 
breakpoint  Is  encountered  (see  the  debugger  Break  command)  or  Ihe  user  Interrupts 
execution  with  an  efiori. 

In  Ihe  example,  (he  user  followed  the  command  with  a siaiu*  request  (the  aiaiMS  character 
itself  Is  not  echoed)  resulting  In  the  first  reply  line  (MACHINE  running  at  ...h  the  target 
machine  is  still  running.  Eventually  Ihe  target  macMne  halted,  producing  (he  second  status 
line  and  returning  control  to  the  exec  as  evidenced  by  the  exec  prompt. 


t 
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Install  adds  a designated  type  of  device  to  the  macNne  configuration. 

(davlcs)  7 On*  of  Ih*  lellowinei 

CnaO-REROCR 
PRINUR 

IRPC-CONIROLIFR 
lERniNIU. 

kINSIRll  (dnvic*)  |i<’*'^RINTER  (CHRNNEL)  !<**« 

»?  SPEED 

»K**^^HE0  {ch.v>*et*r*  p*r  ••eond)  ***3M 
»er 

>i'’*»*MSTRLl  (dovic*)  l««*«Pt-C0RTR0llER  (CNRNNELi  " 

Nom  iMny  TAPE'UNIT'*  do  you  w*nt7 
For  ih*  ltr»«  inPE-UNIT,  (URITI  Oe*C  cr 
»«r 

For  IM  Bocond  TAPE-UNIT,  (UNIT!  fPP 
»rr 

> 

The  device  type  is  selected  from  among  those  implemented.  1he  user  is  prompted  for 
each  necessary  item  of  information,  typically  including  an  address  for  the  device  in  the 
target  lO  address  spare  and  the  number  of  units  to  install.  Alter  the  required  information 
is  gathered,  sub-command  mode  ("»'*  prompt)  Is  entered  to  gather  optional  parameters; 
any  optional  parameter  not  supplied  takes  on  its  default  value.  Subcommands  are 
terminated  by  an  empty  command,  reiurn  only.  An  installed  device  is  initially  unmounted 
— there  is  no  file  associated  with  the  device  for  purposes  of  actual  K). 

When  the  device  being  installed  is  a multi-unit  controller,  the  dialogue  proceeds  through 
each  of  the  irKfividual  units  to  gather  their  parameters.  After  the  command  is  completed, 
the  controller  is  no  longer  visible;  only  the  itrdivldual  units  are.  An  efcori  aborts  the  entire 
command,  not  just  the  current  unit. 

Installation  is  permitted  only,  before  any  execution  has  taken  place,  lypically,  a user  or 
user  group  installs  a standard  configuration  and  then  saves  it  for  use  in  all  subsequent 
sessions  <soo  the  Save -Configuration  ar>d  Restore  commands).  Ihc  optional  parameters  of  | 

an  installed  device  may  be  changed  at  any  time  using  the  Set  command.  I 


( 
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Mount  associates  a file  with  an  inatallad  davica. 

>mO<«’0UNt  (R,I.N,0L,0U.T,r)  f On*  ol  «»m  f•ll•wln9l 
nrpENO 
INPUT 
NCU 
OLO 
OUTPUT 

THIS-TERniNOL 

>mHmT  IR,l,N,OL.OU,T,7)  l•*»«HIS-TERnIMRl  (on  a«vlc«)  p"»«RINTER  " 

>m«*«’OONT  (R,I,N.0L,0U,T,7>  a«»««EM  (In  0 stil  (IU»  AHCD.KI''C;I^**‘  (on  dovleo) 
l«***‘^PE-UNIT  " 

> 

»m  l♦’**^NPUT  (Iron  111#)  enrd.iwk*'*^  (on  aovico)  C«****'R0-RrRnER  •’T 

»f  BINARY  or  RSCII 

»A<’<«^INnRV  (Hi  IN  Syto  slfo)  12*^'^ 

»rr 

> 

Associating  a file  with  an  installed  device  causes  subsequent  emulated  K)  for  that  (ievice  to 
be  directed  to  the  file.  The  second  Keyword  following  Mount  determines  the  direction  of 
data  flow  and  the  choice  of  an  old  (existing)  or  now  file.  A tile  must  be  mounted  on  a 
device  before  any  actual  K)  can  take  place. 

APf’ENO  mounts  an  old  file  for  output  only,  with  thj.  subsequent  output  being  appended 
to  the  previous  contents  of  the  file. 

INPUT  mounts  an  old  file  for  input  only. 

NEW  mounts  a new  file  for  both  Input  i.nd  output  (the  file  is  initially  empty). 

01 D mounts  an  old  file  for  both  input  and  output  (subsequent  output  overwrites  any 
existing  tile  data). 

OUT  mounts  a new  file  (or  output  only.  For  a disk  or  tape  device,  OUT  is  treated  as 
NEW. 

THS'TERMINAl  ass(Kiates  the  user  terminal  — instead  of  a named  file  --  with  the 
naawd  device.  The  mounting  is  for  both  Input  and  output  unless  a file  has  already 
been  mounted  for  one.  In  which  case  the  terminal  is  mounted  only  lor  the  other.  The 
terminal  is  known  to  be  an  ASCII  "file".  The  terminal  may  be  mounted  only  once  for 
inputi  It  may  be  mounted  for  output  (or  on  an  output -only  device)  any  number  of 
times,  but  the  output  is  not  labeled  as  to  source. 

Only  some  of  the  forms  above  are  applicable  to  any  given  device.  For  a disk-  or  tape-like 
device,  an  INPUT,  01 0,  or  NEW  file  is  expected!  an  OID  file  Is  one  that  was  NtW  In  a 
previous  PRIM  session,  arnf  is  being  re-used,  while  an  INPUT  file  is  an  old  read-only  file. 
For  a bidirectional  comnumicalion  device  a terminal),  two  flics  arc  required:  an  INPUT 
file  and  either  an  OUTPUT  or  APPEND  file.  Alternatively,  a real  terminal  may  be  used  for 
both  (or  either  one).  For  an  Input-only  device,  WPUT  and  OLD  are  identical)  for  an 
output -only  device,  OUT  and  NEW  are  identical. 
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For  those  devices  that  deal  exclusively  with  character  data,  the  mounted  file  is  always 
taken  as  an  ASCII  text  filet  character  translation  is  performed  as  part  of  the  K)  process. 
(This  allows  the  file  to  be  created  and/or  processed  by  any  operating  system  utility  that 
deals  with  text  files.)  For  tape  and  disk  devices,  the  file  format  is  internal  to  PRIM  (and 
therefore  not  requested  from  the  user);  the  data  is  recorded  directly.  For  other  devices 
the  user  is  asked,  via  subcommarKi  mode  (*’»"  prompt),  whether  the  mounted  file  (NOT  the 
df'Vice)  is  an  ASCII  text  file  or  a binary  file  containing  a stream  of  pure  data  in  bytes  of 
some  fixed  size.  Ihe  default  is  a binary  file  of  a device-dependent  byte  size. 

Once  a file  has  been  mounted  on  a device,  all  exec  commands  that  refer  to  the  file  require 
the  device  name  as  Ihe  specifieri  for  communication  devices,  where  two  files  are  normally 
mounted,  the  device  name  is  followed  by  a direction  selector.  Ihc  file  name  itself  is  not 
used  as  the  internal  identifier. 

^ws  reads  Ihc  PidM  on-line  news  file. 

Do  you  H«nl  to  SQO  4-nPR-77  Caanyot  In  min  7i  <’*<‘VFS 
I Hero  coMfiii  tho  roy4M*ainy  chanyot  of  4>nf*ll-77  ...  ) 

Do  you  uanl  to  ooo  24-nnR-77  ProllMlnary  Doeunonlal  Ion  7i  XXX 

> 

The  date  of  the  most  recent  news  message  Is  shown  automalically  at  the  start  of  each 
session.  In  response  to  the  command,  each  message's  date  and  subject  is  shown, 
beginning  with  the  most  recent  message.  For  each  message,  the  body  may  be  seen  (YKS) 
or  skipped  (NO),  or  Ihc  command  may  be  terminated  (de/ein  or  nhnri). 

Peripherals  returns  information  about  the  installed  devices. 


>/»e**:tR|f»HrRRlS 


Ch.in 

Unit 

Noun tad 

Oovico 

1 

0 

No 

PRINTLR 

2 

0 

Vos 

UHniNAL 

3 

S 

Ves 

tnrr-UNiT 

3 

1 

Vos 

inrr.UNM 

activo  daviGoRi  ftRniNm  * 

> 

1his  command  produces  a listing  of  all  the  installed  devices,  logciher  with  their  K) 
addresses  and  a nolation  concerning  whether  they  have  files  mounted.  II  also  lists  all 
devices  which  have  suspended  K)  operations.  Ordinarily,  suspended  operations  are  limited 
to  (1)  10  error  conditions  and  (2)  input  operations  where  the  input  file  Is  a real  terminal 
arKi  no  input  was  available  when  target  execution  stopped. 

Qiiit,  terminates  a PRIM  sessioa 

Oullllny  nncHINC  tCantlral 

e 

Terminating  the  PRIM  session  involves  closing  all  open  files  and  returning  control  to  the 
process  that  irtitialed  the  F*RIM  session.  The  session  canrfol  be  continued. 
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Reaetfan  apecifies  a new  file  for  a mounted  device. 

MweOM^SSICN  (a*y|M)  le«MaC4MI1  li*  ItU)  iMm/fla**** 

> 

Ihis  command  it  used  to  aubstitute  a new  file  apecifkation  when,  after  a prior  Restore 
commarKf,  a previously  mounted  file  cannot  be  found.  In  particular,  a restore  done  from  a 
different  directory  than  the  one  in  force  at  save  lime  has  trouble  finding  any  of  the 
mounted  files.  Reassign  may  only  be  used  for  devices/files  that  are  marked  "[not 
openedr  >0  a file  status  display.  The  new  file  is  assumed  to  have  the  same 
characteristics  as  the  old  one  and  is  positioned  at  the  same  file  positioa 

Restore  recovers  the  stale  information  saved  in  a file. 

«lroa  SflVt  KUI  AIICD.CONHC:l**^-  " 
raslorad  CONriCURRTION  Irea  TUESMY,  MtV  3,  1977  l?i3Si9a  POT 

> 

The  current  context  is  updated  with  the  complete  or  partial  environment  previously  saved 
In  the  designated  file  by  the  Save  command.  For  the  addressable  regions  --  machine 
memory,  registers,  etc.  ■ tlie  saved  data  replaces  the  current  data  only  for  those  cells 
that  wore  actually  saved;  cells  not  saved  are  not  cleared.  (Thus,  nonovcriapping  memory 
images  are  merged.)  For  nonaddressable  regions  — symbol,  configuration,  and  breakpoint 
--  each  one  is  completely  replaced  if  present  in  the  tile.  The  dale  and  regionts)  saved  are 
shown,  followed  by  a list  of  any  mounted  files  that  cannot  be  found. 

Rewind  returns  a device's  mounted  file(s)  to  the  beginning. 

>rem«’*«IH0  (dnvic*)  ln<><'^PC-UNIT 


>rrH>  (9,1,0,71  f Ona  ol  Uta  (ollaMinqt 

SOIH 
INPUT 
OUTPUT 

>WM  TIRniXm.  /*’*»TIPUT  " 

> 

This  command  is  useful  for  retrying  a program  without  uninounling  and  remounting  files. 
(Files  are  always  rewound  when  mounted,  except  for  Append  files,  which  canrtot  be 
rewound.)  For  a terminahlike  device  that  requires  separate  input  and  output  files,  the  user 
optionally  specifics  which  file  is  to  be  rewound:  the  default  is  HOTII. 

Save  copies  selected  slate  information  into  a file. 

kMcaryf  f ||„  (ollaMln^t 

net 

CONFIGURATION 

rOATMTS 

nrnoAV 

SVI1901.S 

aSAVe  e<**'^0NriCUAATI0N  (an  Ilia)  •HCO.CONHC;!^' 

> 

This  command  saves  on  the  (new)  file  an  image  of  the  regionfs)  selected  for  saving.  The 
contents  of  the  file  can  later  be  restored  for  (ise  in  this  or  another  sessloa  The  second 
word  of  the  command  selects  one  of  the  save  options. 
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ALL  tiives  everything  — * complete  checkpoint  of  the  terget  marliinc  erMl  debugging 
stete.  "Everything*  includes  memory,  ell  eddresseble  registers,  instelled  devices, 
mounted  files  together  with  their  positions,  debug  brenkpoints  e«Kl  their  programs, 
debug  formats  and  modes,  defined  symbols,  and  the  internal  state  of  ttie  emulated 
machine. 

CONFIGURATION  saves  all  the  macNne  configuration  data,  including  installed  devices, 
mounted  files  (if  any),  machine  parameters,  and  debug  formats  and  modes.  This 
command  is  allowed  only  before  any  eKeculion  takes  place.  Useful  for  creating  a 
standard  machine  configuration  (possibly  with  some  standard  files  mounted)  lor  use  in 
subsequent  sessions. 

FORMATS  saves  all  the  formats  that  have  been  defined  (using  the  debugger  Format 
command). 

MEMORY  saves  those  regions  of  the  machine  memory  that  are  not  clear.  (At  the  start 
of  a f*RIM  session,  memory  is  already  cleared.) 

SYMEIOLS  saves  all  the  user-defined  symbols,  both  those  loaded  via  tlie  exec  Symbols 
command  and  those  defined  directly  via  the  debugger  New-symbots  command.  The  file 
thaf  results  is  a SAVE /RESTORE  file,  not  a SYMDOLS  file! 

$rj>  changes  the  values  of  user-settable  parameters. 

(«»«ipii|>  tr  a«vle*) 

»f  OiMi  at  the  lollMlnyi 
CIQCI. 


SrtIO 

»r****\eci:  (tick*  par  aaeanS)  ereupf  er 

»m<'*nnoav  lai.  ao<iMia«i 

»ar***r|  ar  aavtea) 

»»e»eptni  (etwiraclara  par  aacanSl 


F ollowing  the  command  word,  the  user  selects  the  group  of  parameters  he  wishes  to  alter. 
An  immediate  reinra  selects  the  global  machine  paramelors;  a device  name  selects  the 
parameters  of  that  particular  installed  device  (the  parameters  of  multiple  installed 
InstarKes  of  the  same  device  type  need  not  have  identical  sellings). 

Any  number  of  parameters  from  the  selected  group  may  be  changed.  In  response  to  the 
subcommand  prompt  ("»"),  the  naane  of  a paranncler  and  its  new  value  are  entered;  each 
change  is  made  imafiedialely  and  a rww  subcommand  prompt  appears.  Ihe  command  is 
Irrminaled  by  an  empty  input,  rafem  only,  or  by  an  ekari  (wWch  does  r>ot  undo  any 
paraawters  previously  changed).  Ihe  list  of  possible  parameters  Is  highly  machine  and 
device-dependent;  it  typically  irKludcs  Ihe  size  of  memory  and  the  speed  of  each  device. 


( 


The  value  of  a parameter  is  either  a (decimal)  number  or  a keyword  from  a 
parameter-specific  list;  a eeaiifea  in  Ihe  value  field  reveals  wNch  is  expected.  An  aarepa 
sets  the  paraaaeler  to  its  defaull  value. 
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Show  cNsplayt  the  values  of  all  the  parameters  in  a group. 

ksA****^  ar  SavlMt 

CIOCK  !•  ISM  ticra  pur  aaeana 

mnwv  la  4 as  ■Nxiuiae 

STEED  la  7sa  nAnecacanSa  ear  aaaary  cyela 

><A*’m:0N  (<r«a>lv»  ar  Savlcal  p^’^INTCa 
STEED  la  ?aa  cMraelara  e«r  aitcanS 

> 

Following  the  command  word,  the  user  selects  either  the  global  macNne  parameters 
(reiiirn)  or  the  parameters  of  an  installed  device.  1he  names  and  current  values 
of  all  the  parameters  are  displayed. 

Symbols  reads  an  ASCU  symbol-table  file. 

>ji/'*»^iiaois  (I.M  Ilia)  SYMIIOIS.KXAUPI.K*>**^  " 

> 

Ihis  command  causes  PRIM  to  build  a user-defined  symbol  table  from  tbe  data  in  the 
named  file,  which  is  a structured  ASCII  text  file.  Ihe  file  may  define  values  for  both  global 
symbols  and  program-local  symbols  that  are  organized  into  programs.  In  the  PitIM 
debugger,  the  global  syn:bols  plus  tbe  local  symbols  of  tbe  currently  open  program  are 
accessible  at  any  lime.  Symbol  values  in  Ihe  file  are  octal.  Ihc  form  "name  ■-  value" 
defines  a global  symbol;  Ihe  form  "name  - value"  defines  a local  symbol;  IIk  form  "name:" 
establishes  a program  name  to  which  subsequent  local  symbols  are  assigned.  The  file  is 
free -format  in  that  spaces,  tabs,  commas,  and  new-Uncs  may  occur  anywhere  — except  in 
Ihe  middle  of  names  or  values,  ibe  following  is  a sample  symbols  file. 

AlPHA--0b 
(it  I A- -12345 

PMl:  A-2000,  B-2 132,  C - 2241 
XY/: 

A- 3212  AA-3245,  AAA-326 l,AAAA-7/ 77 

Symbol  files  are  intended  to  support  the  moving  of  symbolic  label  data  from  an  assembler 
or  linKing  loader  into  PRIM  for  use  in  symbolic  debugging. 

Time  displays  time  of -day  and  time-used  information. 

>ii''*Tnr  rut  lucsonv,  nnv  j,  m?  12i34i33-pot 
Usnrf  til4.6  PRin  ItlMi;  Used  tit?. 7 HIP  IlM. 

> 

This  command  displays  Ihc  dale,  tinto  of  day,  the  amount  of  PRIM  tin«c  used  and  the  amount 
of  Ml  (‘-900  time  used  in  this  (4tlM  scssioa  (Elapsed  target  machine  time  is  dispiayed  In 
response  to  atotus.) 

1 ranscript  transcribes  Ihc  subsequent  PRIM  session  on  a new  file. 

>lrT4egnscaipt  do  1 1 lot  NaMv/tfa«>*c  «T 
> 

All  transactions  with  the  user  terminal,  irtcluding  execution- lime  10  to  IINS-IERMRIAL,  is 
irartscribed  until  either  Iho  user  terminates  the  session  (with  a (>iit  command)  or  closes 
the  trartscript.  Only  one  transcript  may  be  open  at  a lime.  A header  line  containing  the 
dale  arKl  time  is  placed  at  Ihe  head  of  the  file. 


e 
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Untmtell  removes  »n  installed  device. 

f fttiHUR  ar  TRK-IMIT 
>UN|NSimi  «l«vle«)  la*«>C-Umi  CunUlil**** 

> 

This  command  is  tite  inverse  of  the  Instah  comaiandi  it  removes  an  installed  device  from  the 
configuration,  first  unmounting  its  tiles  if  necessary. 

Unmount  unnMunts  the  filefs)  from  a devke. 

MtiiiN  ter^***niNni  f On*  al  IIm  lallaMlnfi 

B01H 
INPUT 
OUTPUT 

>ONIT  TfRNINm  <**«“  WTTI 
> 

The  unmounted  filc(s)  are  closed.  For  a Icrminal-liko  device  that  requires  separate  input 
and  output  files,  the  user  optionally  specifies  which  file  is  to  be  unmounted:  llie  default  is 
nOTK 


-i 


M 
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PRIM  DEBUGGER 

Ihe  PRIM  debuftner  is  a table-driven,  larsel-macMrte-indrpendcnl,  inleractivo 
profrem  for  debucimf  e PRIM  emulalor  or  e target  program  rurtning  on  such  an  emulator. 
It  is  tailored  to  a specific  target  machine  by  tables  prepared  as  part  ol  an  emulation  tool. 
Ilaskally,  It  permits  a user  to  set  and  clear  breaKpoinIs  and  to  CKaminc,  modify,  and 
monitor  target  system  locations.  Target  system  assembly  language  and  symbolic  names 
arc  recogrtiied,  and  arilhmelic  Is  performed  eccording  to  the  convenlions  of  the  target 
mAcliine.  The  debugger  command  prompt  character  is  "a"i  each  level  ol  subcommand  adds 
another  to  the  prompt. 

ARGUMENTS 

Most  debugger  commartds  take  arguments  In  Ihe  form  of  values,  eKpressions, 
eapression-ranges,  lists  of  expressions,  or  lists  of  expression-ranges  as  defined  below. 


VekM# 

A value  Is  an  assembly -language  instruction,  a form,  text,  or  an  expression- list. 
Assearbly  language  mslruclioi^  ere  parsed  by  a table-driven  assembler /disassembler  that 
aitepts  the  same  syntax  as  the  asseatbler  for  Ihe  target  machine.  Ur.er  symbols  will  be 
rerogmeed  if  they  have  been  supplied  In  user  symbol-table  files  (see  the  exec  Symbols 
conunatrd)  or  have  been  declared  individually  (see  (he  debugger  New -symbol  commarKl). 

A form  rrepares  tat  the  user  previously  define  a corrcsportdmg  format  (sec  Iho 
di  bugger  format  coaMiiand).  A form  is  represented  by  the  formal  name  followed  by  an 
expression-lisl,  as  in  Ihe  following  example. 

n 0,  7,3 

Text  is  represented  as  a double-quole  (*),  followed  by  an  arbitrary  delimiter 
characler,  followrd  by  a sequerKO  of  other  (non-delimiter)  characters,  followed  by  attolhor 
occurrence  of  the  delimiter  character,  as  In  the  following  example. 

"/TNs  is  text./ 

ExpmaHNia 

An  expression  Is  any  well-formed  sequence  ol  constants  and  symltols  that  arc 
defined  for  Ihe  large!  macNrtei  Ihe  symbols  (wNch  are  ntarhirte-spetific)  may  represent 
eillter  locations  or  operators  whose  rules  of  combination  delcrmirte  what  is  a well- formed 
expressiort.  A location  symbol  may  represent  a named  hardware  element  or  a globally  or 
locally  efefirted  user  localion.  An  operator  may  either  be  unary  (preceding  its  operarnl)  or 
binary  (coming  between  Its  operands  in  infix  relation).  The  precedence  of  operators  is  a 
ftmrlion  of  the  largel  macMne,  except  that  all  unary  operators  are  assimred  to  have  the 
s.rmr  precedence  value,  which  is  higher  (more  slror^gly  birvling)  Ih.m  that  tor  any  binary 
o^teralor.  If  brackets  are  permilled  (e.jr,  parentheses),  their  precedeiKe  value  is  higher 
than  that  of  unary  operators,  for  example,  A-B  ar>d  -OcA  will  evaluate  the  same,  but  will 
differ  from  -(HcA),  wliich  will  evaluate  the  tame  es  -U-A.  A bracketed  subexpression  may 
Itself  attain  the  full  comptexlty  of  en  expression.  The  behavior  of  operators  is 
mac  hiiw -specific. 
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ExpmaloM  raafct 

An  expression-range  consisis  of  the  triple:  expression  (lower  bound),  colon, 
expression  (upper  bound).  It  represents  a sequence  of  locations  starling  at  the  lower 
bound  and  continuing  through  successive  locations  to  iiKlude  the  upper  bound.  Ihe  upper 
bound  may  not  be  less  than  Ihe  lower  bound.  Wherever  an  expression-range  is  allowed,  a 
sir^le  expression  is  accepted  and  treated  as  if  it  had  been  entered  as  both  the  lower  and 
upper  bouTKls  of  a range.  If  Ihe  two  bounds  in  a range  address  different  spaces  (sec  the 
discussion  of  Spaces  below)  wilNn  the  target  machiiw,  the  sequence  of  locations  is 
restricted  to  that  space  addressed  by  the  lower  bound.  Iwo  special  forms  of  expression 
ranges  are  recogixred.  U the  second  expression  in  a range  is  "-r,  it  is  treated  as  being 
the  largest  address  in  the  space  referenced  by  the  first  expression.  If  the  second 
expression  in  a range  is  of  the  form  "«  axpraMiaa'',  it  is  treated  as  if  it  were  "(ionwr 


LlaU  of  cxprtMioM  or  ranges 

A list  of  expressions  consisis  of  at  least  one  expression,  followed,  optionally,  by  any 
mxnbcr  of  occurrences  of  a comma  followed  by  an  expression.  A list  of 
expression-ranges  has  (he  corresponding  structure  of  at  least  one  range,  followed, 
optionally,  by  any  number  of  occurrences  of  a comma  followed  by  a rartge.  An  example  of 
a list  of  ranges  is 

0:10,  20,  3050 

Nolo  (hat  Ihe  second  element  of  tfie  list  (20)  is  an  example  of  a range  with  a defaulted 
upper  bound. 

SPACES 

Addressable  localions  in  a target  system  are  organized  into  constructs  called  spaces. 
A space  consisis  of  a sel  of  addressable  locations  that  is  closed  under  a successor 
function  ar>d  its  inverse  (a  predecessor  (unction).  For  example,  main  memory  constitutes  a 
space,  typically  starling  at  location  zero  and  continuing  through  an  arbitrary  number  o( 
locations.  Ihe  successor  to  the  last  element  of  a space  is  (he  first  clement  in  that  space; 
and  the  predecessor  of  the  first  element  is  the  last  one.  In  some  cases,  machir>e  locations 
are  grouped  into  a space  for  convenience,  even  when  the  concept  of  a successor  (unction 
(or  elements  of  that  space  has  no  correspondence  in  the  aclual  target  system.  Such  a 
space  might  consist  of  testable  Indicators.  Ihe  machine  symbols  arc  identified  in  the 
tool- specific  user  guide. 

For  purposes  of  the  debugger,  every  addressable  location  in  a target  system  is 
represented  by  a pair:  (xpeca,  a/amanl).  When  a range  is  specified,  (wo  such  pairs 
arc  implied.  1o  avoid  ambiguities  where  n and  r.  differ,  the 
debugger  ignores  e aiKf  treats  such  a range  as  a sequence  of  locations,  all  in  space  a, 
starting  with  element  h and  continuing  through  element  4. 

lYNTACTIG  UNITS 

Ihe  bask  syntactic  units  the  debugger  deals  with  are 

1.  Literals 

2.  Symbols 

3.  f’uncluation 
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Literals 

Ulersis  are  character  cortshints,  numeric  constants,  or  single  characters  that  have 
some  encoded  meaning  (which  may  be  context -depertdent).  A character  constant  is 
supplied  to  the  debugger  as  a nnacNrte-specific  character-constant  prefix  siring  followed 
by  a siring  of  data  characters  of  arbitrary  length,  followed  by  a machine-specific 
characler-cortslani  suffix  siring  of  the  general  form: 

Itrrfix-Biring  eherarlar-dete-alrfair  mffix-ttrimg. 

If  the  first  character  of  the  suffix  siring  is  to  be  irtcludcd  in  the  data  string,  it  must  appear 
tJoubIcd.  Character  constants  are  converted  to  binary  (right  justified)  and  are  truncated 
to  fit  the  element  in  queslioa  As  the  form  of  a character  constant  is  macNno -specific,  it 
is  described  in  the  tool-specific  user  guide. 

A numeric  constant  is  supplied  to  the  debugger  as  a machine-specific  (and  optional) 
radix-prefix  siring  followed  by  a string  of  digit  characters  followed  by  9 machine  specific 
(aruf  optional)  radix-suffix  siring  of  the  general  form: 

Itrnfix-Miring  digil-Miring  tn/fir- tiring 

II1C  prefix  and  suffix  strings  establish  the  radix  within  which  the  digit  characters  are 
evaluated.  Ihc  digit  characters  for  any  radix  r are  the  first  r characters  of  the  set 

Coded  characters  have  independent  meaning  only  within  certain  contexts:  at 
appropriate  points  in  the  dialogue  (hey  designate  a particular  debugger  command,  a mode, 
a hreaKpoinI  type,  etc. 

Symbols 

Ihere  are  five  types  of  symbols:  macNne  symbols  that  are  as'-ignrd  to  hardware 
elements  in  the  target  machine,  predefined  opcodes  for  symbolic  instructions, 
user-supplied  names  of  formats,  operators  for  expressions,  and  user  symbols  that  can  be 
assigned  to  arbitrary  memory  locations.  Machine  symbols  arc  given  in  (he  tool-specific 
user  guide}  other  symbols  are  assumed  to  be  familiar  to  the  user. 

User  symbols  are  either  loaded  from  a file  using  Ihc  exec  Symbols  command  or 
individually  defined  using  Ihc  debugger  new-symbol  command.  The  symbols  IncliKle  both 
global  symbols  and  program-local  symbols  that  belong  to  specific  nanwd  programs.  Ihe 
global  symbols  arc  available  at  all  limesi  the  program-local  ones  only  when  (heirs  is  (he 
open  local  symbol  table. 

PMRCtliatiOfl 

Punctuation  marKs  are  characters  with  a predefined  syntactic  (and  usu.Mly  semantic) 
role.  The  purKlualion  characters  are  Ihe  separators  (ramme  and,  in  format  definitions, 
tpere),  the  terminators  (rerern,  axeapa,  and,  in  replacement  operators,  hnrk-tlnth  and 
Mp-erreia),  and  a semantics-lrce  delimiter  (xpeaa).  A'xrapa  is  ut.cd  as  a terminator 
irwicad  of  return  to  invoke  a subconmiand  or  an  additional  feature  of  a command  (e.g^  in 
Modn  or  Breakpoint  commands  described  befowX 
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ERROR  DETECTION  AND  BDITINC 


flobupgor  commends  ere  eKemined  for  errors  ss  they  are  enlored,  character  by 
character.  As  soon  ns  an  error  has  been  delected,  a bell  <bccp)  Is  echoed  and  further 
input  is  reiccled,  except  for  the  generic  editing  characters  ktink-Uftartt,  rnlype,  fcnnlnip, 
dn/nin,  or  eftart. 


COMMANDS 

Urbupger  commands  are  all  single  charactersi  they  can  be  organized  Into  several 
groups:  debugger  control,  execution  control,  display,  and  storage.  Pitch  is  listed  below, 
(hilrss  ollicrwise  indicated,  the  command  character  is  the  first  character  of  the  command 
name. 


Debug  f er  Control 

Debugger  Control  commands  provide  for  user  control  over  several  aspects  of  the 
lic'liavior  of  the  debugger,  they  permit  the  user  to  execute  commands  indirectly  or 
conditionally,  to  return  from  the  debugger  to  the  PRIM  exec,  and  to  control  Ihc  debugger's 
representation  of  data.  Iho  Debugger  Control  commands  arc: 

Dsn.  Calls  a designated  breaK-time  program  as  if  some  breakpoint  associated  with  that 
program  had  just  occurred.  A program  number  must  be  designated  that  corresponds  to  on 
existing  breaK-time  program.  Program  numbers  are  shown  when  the  breakpoint  data  base 
is  displayed  (sec  the  break  command);  Iho  program  llscii  can  be  seen  using  the 
program* edit  command. 

#(/•«  proqrtM  )*<nuiiih«r  ol  an  oxlallnf  Sraak  araeran) 

SUnit  . proqraM  7*‘r 

If  the  use  command  is  itself  in  a break-time  program,  then  a go  command  executed  in  the 
called  program  causes  termination  of  the  callircg  program  as  well  as  ol  tlm  called  program. 

If.  Icsis  Iho  supplied  expression  and,  if  it  is  true,  executes  llw  following  subcommand.  A 
true  expression  is  one  whose  value  is  add;  relational  operators  yield  a value  ol  one  when 
true  and  zero  when  false.  Ihe  tested  expression  must  be  terminated  by  an  exreim. 

#/l  i'loMpraunlont 
1 1 « (hrn>  fflyp* 

aOi  SO  # 

#fl  «n>an>  Zf1V«  0*'' 

0 

Return  Returns  control  to  lice  PRIM  execi  confirmation  is  required. 

0N»turi>  (to  fXICi 
> 


i 


i! 
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Mocte.  Interrogates  default  and  current  modes  and  changes  modes.  A eHeaiien  alter  the 
command  character  M will  alicil  the  default  arKi  current  mode  setlingi  another  eKMiiea  will 
list  all  mode  settings  and  associated  nwde'eode-characlers. 
fAfea*  f 

Currant  amt  (OalMll)  aoda  anlllnaai 


reoftbaek  Verhaaa  (Varbaaa) 

Ouliml  BMt  IS  Mat 

Rddraaaaa  Syaballa  ISyabaltc) 

Llna-farMl  Oanta  (Oanaal 

SmIIk  a (e> 

Typa  r tor  aero 


itioda  ? 
feodtiaeki 
C Cenclko 

V Verlieaa 

Out|Mjtl 
S Site 

F Feraattad  lleraai-flaaat 
I Instruction 

* N Niiaorle 
T loKt 

nddraaaoai 

n nbsolulo 

S Sijnbollc 

L Ino-toraati 
D Dense 

E I Kpanded 

RadlMi 

Sn  a«dlN>baae  n II  < n < 97  doelaalt 
t 

A list  of  mode  sellings  is  expected  following  the  Mode  command;  if  none  is  supplied,  the 
dcfaull  settings  are  reestablished.  If  the  list  is  terminated  by  a rniiirn,  tho  current  modes 
lire  changed.  If  Iho  list  is  lerminaled  by  an  effepa,  a temporary  change  is  made  that 
applies  only  to  the  following  subcommand,  as  in  the  following  example. 

#Afeda  /nnlructlen  ffTypo  0IS.14^^ 

01734 1 JUItP  0067 

0 

Modes  are  cslablished  for  fcedbach  (verbose  or  concise);  output  (bits,  formatted, 
iii.'.lruclion,  numeric,  or  lexth  addresses  (absolute  or  symbolic);  oulpul  line  formal  (dense 
or  expanded);  and  output  radix  (any  base  from  2 through  36). 

Iho  fecdbacK  modes  control  how  debugger  commands  are  reflected  to  the  user: 
ronrintt  suppresses  ail  "noise*  leedbsek  (such  as  command  completion);  tirrhasn  enables 
it.  1hc  output  modes  control  the  general  rapresentation  of  data:  Mis  treats  a datum  as  an 
unsigned  magnitude;  formatted  treats  it  as  a pallorn  of  bits  partitioned  into  contiguous 
fields  according  to  a designated  forn«al  (see  Format  command);  iasirNrifaa  treats  It  as  a 
niachine  instruction  end  disassembles  it;  iwmarie  Ireals  it  as  a signed  value,  if  that  is 
appropriate  for  the  macMnc;  and  last  treats  it  as  a representation  of  a string  of 
cliaraclers.  Ihe  addrass  modes  control  whether  iHimeric-mode  values  are  to  be  converted 
lo  symbols  (if  possible):  »ki»tm$0  suppresses  Ihe  symbol  looK-up;  tymftolle  enables  It.  The 
line-formal  modes  control  Ihe  density  of  displays:  dansa  suppresses  most 
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debugger 'generated  line-feeds  so  as  lo  show  more  information  per  line,  espended  enables 
them. 

When  formatted  output  Is  selected,  the  name  of  the  output  formal  must  be  specified, 

as  In: 

^'orMllad  FI  **■. 

Output  radix  sets  the  number  bass  for  the  representation  of  numeric  data  (note  that 
numeric  input  data  scif-idenlify  the  number  base).  For  example, 

fAfoSa  ffaillM  16 

causes  current  output  radix  lo  become  hexadecimal. 

Format.  Permits  the  user  to  name  and  define  a format  as  a list  of  fields,  each  of  which  is 
a designated  number  of  bits  wide.  The  field  widths  are  supplied  as  a list  of  numeric 
constants  (separated  by  commas  or  spaces). 

#F'ar«wt  F K**  1 4 6 r*" 

f 

#Ala«la  F'arMUad  FI  <***  iFTyifm  0®^ 

•Si  M,M,N,N  # 

If  the  formal  command  is  ternMnated  without  having  defined  a format,  all  defined  formats 
are  displayed,  as  in 

#ForMl 

FI  2,«,S,a  t 

Comment.  F ollowing  an  initial  semicolon,  ignores  all  siibscquenl  Inputs  up  to  and  IrKluding 
a line  terminator. 

0;  THIS  IS  /I  imnUiNT’-ir  DOKS  not  CKT  INTKRPKKTKIlf' 

0 

Nrw-svmbot.  Adds  a list  of  new  user  symbols  lo  the  (possibly  empty)  global  symbol 
table.  Each  new  symbol  in  the  list  is  supplied  as  a name  followed  by  a apnea  or  an  nseepn 
followed  by  an  expression  giving  its  location. 

#iVeH-»w>bel»  <{SC>  (•MarMtlnn))-! lal) 

moN-ntpiboiK  €ai>  07000<Kr 

#7Va  F/nx:ii,FAir.ih  i,r/ircihit‘' 

PflTCHi  M ar>7777i  ••  MTCNftll  H 0 

Kill- symbol.  Removes  a list  of  user  symbols  from  the  open  local  or  global  symbol  table. 
FCIUI-*t-Mar>Byaa*ls) 

067777:*2^>‘ 

aC7777l  H a/SONi  H •7SMli  N 0 

Oprn-svmbot-tabic.  Opens  a local  (program-specific)  symbol  table  if  one  is  specified}  the 
currently  open  local  symbol  table,  if  any,  is  closed  in  any  case.  After  this  commar>d  is 
executed,  the  available  syndaols  Include  the  global  symbols  plus  the  local  symbols  ot  the 
specified  program}  if  no  program  is  specified,  only  the  global  symbols  are  available. 

<OMn-arsy an  aySsIs  F(arnyran-aana)  sr  aal  xelaaa  Uta  aean  local  avnbol  tablo> 
fOeon-arofran-aynaols  ®F 
0 
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ExccHttoii  Control 

txccution  control  commands  provide  for  user  control  over  execution  of  tho  target 
program.  Ificy  permit  the  user  to  continue  execution,  transfer  to  a designated  location, 
set  and  clear  breakpoints  or  edit  break-time  programs,  and  single-step  the  target  program. 
Ihc  execution  control  commands  are 

Go^  Passes  control  to  tfio  target  machine  in  its  current  state.  If  an  argument  is  supplied, 
its  value  is  first  stored  into  the  program  counter.  1he  argument  can  be  an  arbitrary 
expression,  so  long  as  it  evaluates  to  a legal  memory  address. 

tCo  lie)  ?loxpreft«len)  or  aeply 

«Se  lie)  O/OOIK*' 

nrcnl^  Displays  or  sets  breakpoints  in  the  target  machine.  Ihc  two  classes  of 
breakpoints  are  known  as  event  breakpoints  and  reference  breakpoints.  There  is  a fixed 
srI  of  event  breakpoints  defined  for  any  given  target  machine;  each  describes  a typo  of 
event  wliose  occurrence  causes  the  emulator  to  break  if  tt>c  corresponding  event 
breakpoint  is  scl.  The  set  of  event  breakpoints  always  includes  (1)  every 
inslruction-excculion  (single  step),  (2)  every  branch  of  control,  and  (3)  every  memory 
write;  other  events  arc  defined  for  each  machine  as  appropriate.  Reference  breakpoints 
cause  the  emulator  to  break  when  a specific  type  (read,  write,  and/or  execute)  of 
reference  to  a specific  location  occurs.  Reference  breakpoints  may  always  be  set  on 
mc>mory  locations;  other  spaces  in  which  reference  breakpoints  may  be  set  are  detailed  in 
lltc  tool-specific  user  guide.  Any  number  of  reference  breakpoinis  may  be  set  at  any 
time. 


The  break  command  followed  immediately  by  a reiitrn  causes  all  existing  breakpoints 
(i.e.,  those  in  the  breakpoint  data  base)  to  be  displayed;  if  a break-time  program  is 
associated  with  a breakpoint,  its  number  is  also  displayed.  Otherwise,  a list  of  either 
events  or  ranges  (reference  locations)  for  the  selling  of  breakpoints  is  supplied.  It  a list 
of  ranges  has  been  entered  and  terminated  with  an  rtenpe,  tlien  a list  of  read,  write,  or 
execute  reference-break  cor^ditions  is  specified  next  (as  permitted  at  those  locations);  the 
dc'fault  is  all  three  types.  Whenever  a breakpoint  is  set  for  an  event  or  a location,  any 
earlier  breakpoint  for  that  same  event  or  location  is  superseded. 

If  the  list  of  events  or  t>reak  types  is  terminated  by  an  r.%ro/tr,  as  In  the  second 
example  below,  a break-timo  ’program”  may  be  supplied  to  bo  execulrd  by  the  debugger 
wlien  the  break  is  ctKOuntered.  Ihe  following  commands  arc  permillcd  within  such  a 
break  program:  Clear,  Comment,  Ocbreak,  Evaluate,  Go,  If,  Jump-history,  Locate,  Mode, 
Open,  Sol,  Type,  and  Use.  RoplacemenI  witNn  a locate  or  type  commarKi  is  not  permit  led 
in  a break-time  program.  Any  number  of  commands  can  be  included  in  a break  program; 
Ihe  program  is  terminated  by  an  amply  commarKi  (terminator  only). 


1 
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WIraak  (•(>  )*(ev«nl-l laO  ar  ((aiifraaataii-ranea)»llaO  ar 
<7  for  I tat  of  avania> 

IBraak  (aO  0f2.1.‘045fl,  0712***^  (altar  ealnf) 

<R,U,X>  # 

#/fraak  (al>  0I0(HK*^  (altar  ealnft  Jfaoita  •** 

##)'ypa  0^' 

##Co  (to) 
f#rr 

<l're9raa  mmbar  la  (1)>  0 

ffiraak  (at)  VICK*^^ 

0 

0ltrtak  (at) 

tl?3-*4S6  <R,U.X>  07J?  <R,M,X>  tlMR  <X>(1)  TICK  <avonl>  0 

During  program  execution,  if  an  event  break  is  detected,  or  if  a reference  break 
(read,  write,  or  execute)  is  detected  at  a location  for  which  the  corresponding  break  type 
has  been  specified,  then  execution  is  terminated  before  beginning  the  next  target  machine 
cycle  and  control  passes  to  the  debugger  to  process  the  break.  It  a brcak~timc  program 
has  been  supplied  for  that  break  event  or  ICKation,  the  program’s  commands  are  executed 
in  order  by  the  debugger  until  either  a go  command  or  the  end  of  the  program  is 
encountered.  If  several  breaks  occur  on  the  same  cycle,  the  program  associated  with  each 
of  them  is  executed:  the  order  of  break-program  execution  corresponds  to  the  order  in 
wltich  the  breaks  are  reported  by  the  emulator.  If  every  break  causes  execution  of  a Go 
command,  then  the  target  program  is  automatically  resumed,  provided  there  is  no 
ambiguity  as  to  where  execution  is  to  resume.  Otherwise  (f.e.,  if  any  break  had  no 
program  or  failed  to  execute  a Go  command),  a message  describing  each  of  the  breaks  is 
displayed  and  the  normal  command  level  of  the  debugger  is  entered. 

Debreak.  Clears  event  breakpoints  or  reference  breakpoints  at  locations  in  tho  target 
machine.  The  default  is  to  clear  all  breakpoints.  Examples  of  debreak  commands  are 

0li*hrm/>k  (IroM)  02^4:*  4^-^ 
f/lrakk  (at) 

tl?3-0233  <R,U,X>  a?41.S4SC  «R,H,X>  0712  <R,H,X>  #1000  <X>tl) 

TICK  <«v«nt>  0 

ODobraak  (Irea)  all  IronllralOl’ 
offraak  (at)  " 

0 

Program- edit.  Displays  a designated  break-time  program  or  permits  it  to  be  edited.  A 
program  number  must  be  designated  that  corresponds  to  an  existing  break-time  program. 
Program  numbers  are  shown  when  the  breakpoint  data  base  is  displayed  (see  the  break 
command).  If  the  command  is  terminated  by  a reinra,  the  entire  program  is  displayed:  if 
by  an  eore/M,  the  program  is  displayed  line  by  line  for  editing. 
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fiiiMk  uo  .sTirpM* 

MTV* 

ttC*  (tol 

<rra^Mi  iMNPtMH-  u i7i»  a!^f%m  to«i 

•P3-I733  IPtl-MU  «I.M>  tMI  •IN*  <X>in 

line  <«v«nl»  lUf  <*v«mI»I2I 

aVrwra*^  c4H  2(|ira^w-NHiAar)  XH  ar 

MrofTM  a<<(t 

lyi**  coincc 

Co  (to) 

a 

When  editing  a line  of  a brcak-lime  program,  Ihe  user  can  specify  that  the  next  (\)  or 
prior  (t)  line  be  displayed  or  that  a replacement  (R)  of  the  riirrrnl  line  or  an  insertion  (I) 
in  front  of  the  current  line  be  made.  Editing  is  terminated  by  an  empty  editing 
specification.  Replacement  or  insertion  is  identicai  to  the  specification  of  a break-time 
program  within  the  break  command  in  that  a subcommand  mcKie  is  entered  where 
successive  break-time  commands  can  be  entered  until  an  empty  command  is  supplied;  then 
editing  continues  with  the  next  line  of  the  program.  An  extra  (dummy)  last  line  is  added 
when  editing  a program  so  that  new  commands  can  be  inserted  at  the  end;  the  dummy  line 
is  discarded  when  the  command  is  terminated 

T^lta  rOinCC  i}*(t  <|N‘tor>>  mr  (\  <n«Kl>)  or  ((l<nsar(>)  or  <R<«|>lac*>) 

(roMMnds))  } 

lyrsrmncc  iK«pi«c« 
aaMoau  /nairucDon  aaaT^ 
agcr 

Co  do)  i" 

#/VoqrMi-ea«l 

node  Inolrucdon  f##lw>*  SOIOCC 
Go  do) 

a 

Single- step,  transfers  control  to  the  target  program  through  the  program  counter  for 
execution  of  one  instruction,  the  single  coded  character  (fna-/aed  effects  this  command. 

Display 

the  display  commands  permit  the  user  to  search  or  examine  the  contents  of 
designated  locations  (and,  in  two  cases,  optionally  permit  their  replacement)  or  to  evaluate 
expressions.  Ihe  commands  are: 

Type,  Displays  location  and  contents  of  a list  of  expression-ranges,  permitting  the 
contents  of  each  location  to  be  replaced  If  Ihe  list  Is  terminated  by  an  asrapa,  as  In  the 
following  example. 

#TV*  i*((*x|N'*sitloa-ran^)-d«()  epdenal-<«tcap«>-to-aeddy 
aiya*  SOi  St  . I" 

•ii  St  ■ r'*' 
t?i  St  > .V’*' 

a 

Iho  replacement  value  can  actually  be  ■ list  of  expressions,  Ihe  values  of  the  expression 


1 


iniinlirrrTi 
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in  the  list  going  into  successive  locations  starting  with  the  one  last  displayed.  If  rK>  r«ew 
value  is  supplied  before  the  terminatOTi  the  existing  value  is  not  modified. 

aT'WM  SOi  SI  - Sli  S2  • I2i  t3  . » 

In  Oisplay-with-replacement  only,  the  coded  characters  haek-»la*h  and  lap-arrew  can 
also  serve  as  terminators  and  perform  special  functions:  hack-slanh  causes  the  next 
location  to  be  displayed  for  replacement  and  «p-arroMi  causes  the  prior  location  to  be 
displayed  for  replacement;  both  of  these  terminator  characters  permit  the  user  to  step 
beyond  the  limits  of  the  ranges  entered  as  arguments  to  the  1ype  command. 

#7V«  OtO*’*'^  sisi  ss  ■ It  S7i  ss  > 1\  Slot  SI  . .1\  sill  so  « T 

SlOi  S3  > 4t  07t  s?  - St  S6i  ss  ■ \ S7i  SS  - \ OlOi  S4  . \ 

Sill  SO  ■ 6\  Sl?i  SS  ■ 7*“' 

t 

the  last  location  displayed  by  a type  command  becomes  the  'open*  location,  and  the 
location  following  the  last  one  displayed  or  replaced  becomes  the  "next”  location  (see  the 
next  four  commands). 

Same.  Redisplays  the  "open*  location  (sec  the  type  command),  the  single  coded 
character  V effects  this  command,  the  commands  Same,  Prior,  and  Next  are  all  shown  in 
ttic  following  example. 

f:  S?i  SI  at  SI  I S?  «\  S7i  SI  f\  S3i  SS  t 

TlliPrj.  Displays  the  location  at  one  less  than  the  "open"  location  (sec  the  typo  command), 
the  single  coded  character  uft-nrrou»  effects  this  command.  See  the  examples  under  type. 
Same,  and  Equals. 

f^xt  Displays  the  "next"  location  (See  the  Type  command;  the  mode  in  which  the  open 
location  was  last  displayed  determined  how  far  it  was  advanced  to  the  "next"  locations.) 
The  single  coded  character  hnek-itntk  effects  this  command.  Sec  the  examples  under 
1 ype.  Same,  and  ( quals. 

Equals^  Displays  the  "open"  location  (see  the  Type  command)  as  bits  or  as  a number  if 
the  currenf  output  mode  is  already  bits.  The  single  coded  character  ">^"  effects  this 
command.  In  the  following  example  format  t'i  has  been  declared  consisting  of  four 
half-word  fields. 

i:  aiat  eo,ai.a2,i3  0-  aiai  ai  #\  aiii  •2,a3,c4,as  #\  ot3i  oG,a7.oo,ti 

#T  ai7t  t4,as,K,a7 

Locate.  Finds  cells  In  a list  of  expression-ranges  that  contain  (or  do  not  contain)  a 
specified  value,  examining  only  those  bits  designated  by  an  optional  mask,  and  displays 
their  locations  and  contents,  permitting  each  displayed  value  to  be  replaced  if  the  list  is 
lerminalod  by  an  nurnpn.  Ihe  comparison  value  and  mask  arc  expressions  terminated  by 
an  eitrapm  the  comparison  value  defaults  to  "NON  0"  and  the  mask  defaults  to  all  I’s.  The 
search  is  performed  over  a list  of  ranges,  as  for  the  Type  command. 

afrftcal*  )*<(ri(pr«Rsisn)  or  N(M  (•xarssslMl)  <«Mlch  valu«  tfflaulU  !•  NON  •> 

Jl  neats  NON  (mIIN  aatk)  FtoallaMl-axarststan)  <M»k  valu«> 
llncala  NON  0 (hIUi  aask)  tara>  tin)  f ((aKarsi>klan-ran9**~l 

sptlonal><ISC>  lo-Moeilti 

flocals  NON  a (Milh  Mask)  <nal  iara>  (In)  9:070^ 

tei  ti  ail  a?  a?i  as  . a7i  aa  aiai  a4  aiii  aa  ai?i  ar 


i 
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example,  s-iihliont  ton  ooliw  jirtiiJixf?  O'  ■ ' o^o  ,..  tTi  q’tu 

ffrftcai*  070****  (nIiIi  Mciil  (^O***  lln)  titibr  ^ * ** 

fxon  '»l^t  i\;ici<?.  ■.■'ooitjnii  leii'tqi  miohoq  bnn  ' ■>(  ."•r.  9vi’j.t  o.’K 

Mi  ni  rutWwn  !t}P,qCO,t»i«tiv»„^»  t,wwif»f>ff4„by  bebi««cr.  Mch 

qof!>«W*Xo<»?i  RbTfwW  ^?R^WRVi%  fRrtlb^„^:)^P•^<cawm<MH<.  loti  jlnom  iMUiVm  lul  boyKiq.  ib 

M90^"*  tf'  *a,'rt  ttiU  bnoy  to 


ai7i  17  ■ cr 

I -.  «()  1 1 to 


/>'.  . 10  lino  /i  - BO  -VO  M » 00  lOio 
/ • Ml  mo  / > ,!0  iia  / .-  OH  .00  I?,  '■.o  :',n 


•>'•■'01 » 
fV  • 10  lOiu 


IT  , o>  ■ t; ! 0 ■'  00  1 1 0 

.Inmp-hislory.  Displays  the  most  recent  target-program  jumps  In  the  order  they  ^occurred. 

1 he  number  of  such  Jumps  to  display  (taken  modulo  the  default  value)  may  be  supplied. 

iitl  bns  ."'1  ' iii'  'HI  ',1'  o)ori  h(M-rfM-flOJ  .HlVt  S y<i  liov.  f’lli  n-.-ilmoi  i .i  oil 

'-.'-■I  ^ 

tim-KMU  '.1—.  m.-,lM  , l.-.n 


^ tvaluil^''  Plaints  ll'ib  VMIUd  of rt' hiis’ftb  ef^^ct  bh  tKe''biMn  Irceiion 


ni 


fAfoM-avUMl* 

fKvaiMt*  • aratN  # 


10  ISO 


il'i 
so  :|0  U 


tbcal 

t'  il.T.I' 

.X  I rjqisvolioi  ')ii/ 
10  r-n  4 


.ibin.Mi'Tim  myT  q.ll  n i.-)  noiir,  inl  it  kio"  tiill  umI!  .' ...i  'too  lii  oo'ist'.-  il  o.  i.lq -.Cl  i.jit'i 
..xfilonfo  ■ij  e'llqfnr.vi  >il!  iq.’  .boc.irifoo  .tint  .'I  tolla  Htono  t\f.  . tltr.i'.il  > b '-ot  tb-  i.'  till 

'•t'lr  I . ’ 

Storage  commands  change  the  contents  of  designated  locations  without  displaying 
ehanging  the  "opco”  l9catiOfv  Ihp  storage,  commands  are  ' ■!  k .:i 

I.  MMjitr.  )Ol  lx  >n'  till  ol  It  ■Of.'  I,  f.w  !i  ir.l  wort  hortiio  inl  ib  boy ''.In.'  i -.1  - .lOilh  -i  1 

1 (b®  (Onlents  of  g list,ol  expr|iess|9p-;fi(ncps  lot  all  ?ero  biliw  Clearing  | an 
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TARGET  IXICUTiON  STATE 

1 erect  execution  is  initiated,  or  resumed,  throunh  explicit  commands  (excc  Go, 
debueeer  Go  or  Single-step).  Execution  proceeds  until  a terminating  event  occurs,  causing 
control  to  return  to  the  appropriate  PRIM  command  level.  Wlien  execution  terminates,  the 
entire  emulated  context  — including  clocks  and  oulsianding  K)  operations  — is  cleanly 
frozen  until  the  next  time  execution  Is  resumed.  Except  for  explicit  modifications  to  the 
context  made  by  the  user  at  the  command  level,  the  termination  and  subsequent 
resumption  of  execution  is  transparent  to  the  target  macMne.  1 he  terminating  events  are 

Ihe  target  machine  halts  normally  or  is  interrupted  (by  the  emulator)  due  to  the 
occurrence  of  some  anomaly  condition.  A message  to  that  effect  is  generated.  Ihe 
anomalies  being  monitored  are  listed  irt  the  tool-specific  user  guide. 

Ihe  user  enters  an  eAori.  Ihe  abort  character  is  echoed  and,  after  execution  is 
stopped,  a status  message  is  output  indicating  the  point  of  interruption. 

Ihe  emulator  delects  the  occurrence  of  a break  condition  estabiislwd  by  the  user  via 
the  debugger  breakpoint  command.  The  establishment  of  breakpoints  and  the 
subsequent  interruption  of  execution  at  the  time  of  their  occurrence  is  the  primary 
program  debugging  tool  in  PRIM. 

An  K)  error  occurs.  A message  detailing  the  particular  device  involved  and  the  nature 
ol  Ihe  error  is  output.  K)  errors  always  return  control  to  the  exec  state;  the  error 
aK'ssages  and  their  meanings  are  listed  at  the  end  of  this  section. 

WlK'n  ofV!  of  these  conditions  occurs,  it  Is  logged  and  execulion  conlinucs  until  the  end  of 
I In'  current  cycle  of  Ihe  target  emqlator.  It  Is  therefore  possible  for  multiple  corKiilions  to 
result  in  a single  stop.  When  this  (»  the  cdse,  the  action  and  message  appropriate  to  each 
of  Ihe  conditions  is  produced. 

Wlwn  a breakpoint  is  delected,  Ihe  debug  program,  if  any,  associated  with  each 
breakpoint  is  executed  by  the  debugger  before  control  returns  to  tlie  commarN)  level. 
SiKiuld  some  break  program  lerminale  without  a Go  — or  should  there  be  some  break  with 
no  break  program  — a nwssage  describing  Ihe  break  is  output  and  lire  command  level  is 
entered.  Otiwrwise,  execulion  is  automatically  resumedi  the  user  receives  no  irrdication 
that  a breakpoint  occurred  unless  the  break  program  itself  produced  output. 

TARGET  I/O 

The  target  machine  that  runs  in  PRIM  consists  of  a processor  (CPU)  in  some 
particular  configuration  buili  by  Ihe  user  to  resemble  the  aclual  configuration  required  by 
his  programs.  A configuration  is  built  — before  execution  Is  begun  --  by  installing 
peripheral  devices  and  oslablisNng  values  for  various  machine  options  (see  the  exec  Install 
and  Scl  commarNfs).  After  an  emulated  device  has  been  installed,  and  before  K)  operations 
enn  proceed  on  that  device,  a (lENEX)  file  or  assignable  device  must  be  associated  with 
that  emulated  device  (see  the  exec  Mount  command).  Subsequent  10  operations  addressed 
to  that  device  arc  then  performed  on  the  mounted  tile. 

A mounted  file  may  contain  either  direct  device  data  (binary)  or  ASCH  text;  in  the 
latter  case,  characters  are  translated  between  ASCM  arKi  the  actual  device  character  set  as 
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lliry  arc  processed.  (If  the  device  character  set  does  not  include  lower  case,  input  lower 
caao  letlers  are  converted  to  upper  case  before  translation.)  When  the  target  device  is  a 
record-oriented  device  (a.arn  card  reader  or  punch)  and  tho  file  is  ASCII,  then  each  record 
operation  Is  pcrfo'’mcd  on  a line  of  the  ASCII  lext  file,  including  truncation  and/or  blanK 
padding  on  input. 

1hc  mount  option  TIIIS-THRMINAI.  associates  tho  user  terminal  (Iho  one  being 
used  to  communicate  with  PRIM)  with  a given  device.  When  the  terminal  has  been 
mounted  on  some  device,  then  irtput  from  the  terminal  is  switched  between  PItIM  and  the 
target  machine  every  time  execution  is  resumed  and  terminated.  1he  intervention 
characters,  however,  retain  their  intervention  meanings.  1o  allow  the  full  ASCII  character 
set  to  bo  input  to  the  target  device  from  the  terminal,  there  is  a tnnirol-Khifi  escape 
character  defined  during  target  execution.  1o  help  distinguish  PRIM  output  from  target 
output  directed  to  TIIIS-TKRMINAI.,  all  PRIM-generaled  output  is  prefixed  with  the 
herald  "— > " at  the  beginning  of  a new  line.  IMs  applies  in  particular  to  both  slopping 
messages  and  lypeout  resulting  from  breaK-lime  debugger  programs. 

I/O  ERROR  MESSAGES 

Various  I/O  errors  may  occur.  When  any  one  occurs,  execution  --  including  tho 
error-generating  operation  — is  suspended,  and  control  returns  to  the  PRIM  exec.  When 
execution  Is  rtext  resumed,  the  suspended  operation  is  retried  unless  it  has  been  explicitly 
canceled  by  tho  user  using  the  exec  Cancel  command. 

"I  ile  r>ot  mounted." 

Ihe  indicated  device  has  no  file  mounted.  If  a fMe  is  axHinlcd  before  execution  is  next 
resumed,  the  operation  will  be  performed  then.  (An  installed  device  to  wNch  no  10  is 
directed  need  not  have  a mounted  file  in  order  to  run.)  the  operation  may  instead  be 
canceled. 

1his  message  is  also  produced  when  an  output  operation  occurs  on  a device  which  has 
(K-cn  mounted  for  input  only,  and  vice  verse.  Again^  a second  file  must  be  mounted  on 
Ihe  appropriate  side  of  the  device  in  order  to  proceed  normally  with  the  program. 

"f  ile  not  open." 

Ihe  indicated  device  has  an  inaccessibie  file  mourded  on  M.  liv'  device  must  either  be 
reassigned  or  urwnountcd  arvl  then  mounted.  Ihe  situation  is  similar  to  the  case 
nl}ovc.  except  for  the  possibility  of  reassigning. 

"Improper  tape  format  delected." 

UNIX  files  wliich  are  mounted  on  target  atagnelic  tape  devices  ate  encoded  in  a 
unique  internal  formal  that  requires  such  files  to  be  used  only  for  PRIM  magnetic  tape 
devices.  Ihe  mounted  file  is  inconsistent  with  that  foramt.  Ilie  device  amist  be 
unmounted  aiKf  replaced  with  a proper  tape  file. 

"Device  not  installed." 

A device  that  is  referenced  by  Ihe  program  Is  not  Installed.  Should  Ihe  missing  device 
be  required,  there  is  no  way  to  continue  INs  session,  since  device  installation  is  rw 
longer  allowed.  Should  Ihe  reference  be  a mistaKc.  execution  may  bo  continued  down 
a different  path  (the  operation  will  be  aulomaticalty  canceled  when  execution  rosumesX 
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"ASCN  input  ch«rflclcr  not  recoenized  -•  ienorcd.” 

Tlw  last  character  read  from  the  ASCN  input  file  on  the  designated  device  was  not  ■ j 

translatable  into  the  character  aet  of  the  device.  Ihe  character  has  been  skipped  ! 

overt  resuming  execution  causes  the  read  operation  to  continue  with  Ihe  r«ext 
character  in  the  file.  Ihe  position  of  the  offending  character  in  the  file  may  be 
determined  via  the  exec  Filcsiatus  command,  specifying  the  indicated  device. 

Any  other  error  indicates  a bug  either  in  Ihe  emulator  or  in  PRIM.  Such  errors  should  be 
reported. 
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